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* * * * SUPER 3D PLOTTER XX * * * * 


- INTRODUCTION - 


You are now the proud owner of the most sophisticated 3D graphics package 
available for the ATARI. The program has undergone major changes since its* first 
release in April, 1985, and is now packed with more features then ever. Before 
jumping right in, let’s take some time out to get some background on this 
fascinating subject. 

The process of creating images by controlling the "screen memory" in any 
computer is called Bit Mapped Graphics. Bit mapped graphic animation is 
accomplished by rapidly changing the screen memory, in order to give the illusion 
of motion. This is generally considered the most difficult method of creating 
a nimatio n, and if 3 dimensional images sure involved, the process is even further 
complicated. Many programmers who have endeavored to approach this task have 
discovered that even in machine language, completing all the calculations needed 
to produce even a single detailed line drawn image, tends to bog down the 
computers processor; -especially on a small "8 bit" machine. As a result, screen 
updates occur so infrequently, that all practical application as an animation 
package is lost. With Pseudo 3D imagery (as found in ZAXXON and s imilar games) 
these problems are partially overcome by using the computers built in "hardware" 
capabilities such as FINE SCROLLING and ’PLAYER MISSILE’ graphics. While these 
techniques are useful in game applications, they offer very little in terms of 
changing perspective, rotational capability, and other commonly expected 3D 
effects. True 3D animation must rely on extensive mathematics and principals of 
solid geometry. As such, the few programs that do display a reasonably accurate 
3D rendition must do so by sacrificing. Half screen displays and limited 
resolution and control are usually the result. 

Enter SUPER 3D PLOTTER II. Full screen, detailed HI-RES images are smoothly 
rotated and moved about at an incredible rate of 3-6 screen updates per second! 
Make no mistake, the limited capability of the ATARI is still a factor. Truly 
perfect animation would require at least 30 updates per second to fool the eye. 
The 3-6 screen/second rate of SUPER 3D PLOTTER is however, very impressive, and 
quick enough to draw you into the illusion that your creation is real! Special 
programming methods were necessary to produce this processing speed on a full, 
hi-res screen, and some of these will be discussed in section 4 of this manual. 
Many special features such as INTERACTIVE GRAPHIC EDITING and HIDDEN SURFACE 
ELIMINATION are also available, and I would like to stress that this is not a 
program to ramble thorough in one sitting! If you’re among those users who 
believes that studying a manual sounds too much like work, this program may not 
be for you. In designing the package, I have tried to incorporate enough options 
to make virtually anything possible, and the entire 48K of directly addressable 
ATARI memory has been put to very good use. I suggest reading through each 
chapter before attempting to use any of the features described. The manual has 
been prepared in tutorial style, presenting progressively more complex functions 
and challenges as you proceed. I personally guarantee that you will find no end 
to the range of graphic possibilities, as you learn to combine the functions and 
features available. From here on we will refer to the program as S3DP. Now, let's 
explore the amazing world of 3D graphics in the pages that follow. 
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**** STATEMENT OF POLICY * * * * 


Any defective disk will be replaced FREE within the first 60 days of 
purchase. Return postage, original disk, and a suitable disk mailer are a must 
for all replacement claims. Following this 60 day period, a £5.00 replacement fee 
is in effect. Enhanced or updated versions can be purchased at substantial 
discount with return of the original disk, plus a fee to be announced via 
newsletter. Warning: Writing data of any kind to the S3DP master disk will void 
all replacement rights. Also, attempting to make copies may result in damage to 
your disk drive for which I assume no responsibility. Replacement claims bearing 
any disk other than the master S3DP supplied, or any alteration of the original 
will be instantly detected and tossed in the "circular file". I apologize for the 
need for this firmness, but I have made adequate provision for any honest 
replacement need that should arise. Also, considering the content of the program 
and the low sale price, I feel that there is no excuse for any attempt at piracy. 

**** DISCLAIMER * * * * 


In a program of this complexity, it is typical for programmers to limit the 
number of allowable function combinations, in order to assure "logical" operation 
by the User. To me, this trend in "steering" the users’ options (especially in 
applications programs) reflects a lack of respect for the users* intelligence, as 
well as a lack of confidence on the part of the programmer. My design philosophy 
in the S3DP has been to keep options as wide open as possible, limiting 
combinations only when necessary. However, because of the number of possible 
combinations in this program, 100% testing is almost impossible. It is therefore 
possible, that some combinations of features may not make sense, even though such 
combinations may be allowable. I mention this because with such a "wide open" 
design, it is also possible that some combination of functions will reveal a bug 
that may have escaped detection during program testing. Therefore, in order to 
speed up correction of any such problems, it is important that I get detailed 
feedback from S3DP users. Should you wish to convey any such information to me, 
please write and specify the exact nature of the problem, and the conditions 
under which it occurred. Due to the exhaustive testing performed, such problems 
are not expected. But as you know, anything is possible. 
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**** SUPER 3D PLOTTER II **** 

SECTION I: 


1.1 PREPARATION.. 

Before doing anything else, ’’boot up” your ATARI with a disk containing DOS 
2.0s, format at least 2 blank disks (OPTION I), and write DOS.SYS files (OPTION 
H) to both of them. These will be used later for ’’image data” files and should be 
marked accordingly. If you do not own a copy of DOS 2.0s, you should obtain one 
as soon as possible! However, you do not need DOS 2 to use the S3DP. For now, you 
can prepare a few such disks using the following procedure: Boot up the master 
S3DP disk with BASIC (XL/XE users don’t , hold down the option key). When the 
screen turns RED, press the BREAK key, followed by RESET. The BASIC READY prompt 
should now appear. Remove the S3DP master and put a blank disk in the drive. Now, 
type in the following commands, pressing RETURN after each: 

NEW 

XIO 254,#1,0,0,”D:” 

This will prepare the disk in DOS 2.0s format for later use when saving "image 
data” files. 


1.2 STARTUP 

All cartridges should be removed from your ATARI. In later chapters, you 
will also need a joystick inserted in PORT 1. Turn on your disk drive, wait for 
the ’BUSY* light to go out, and insert your master S3DP disk. If you have a 
printer on line, power it up now as welL Next, power up your ATARI and remember 
to hold down the OPTION key if you have an XL or XE, to disable the built in 
BASIC. After a short pause, the screen will turn RED and the "beeping” from your 
television speaker will go silent for the remainder of the load. During this 
time, you should adjust the color, tint, and brightness controls on your 
television, for a pure RED screen, with a BLACK border. One of the graphic modes 
in the S3DP uses a process known as ’artifacting’ to create its’ colors, and this 
TV setup will usually give the best results. Shortly there-after, the TITLE 
screen will appear and your printer will churn out a short message: 

** SUPER 3D PLOTTER Ver. 2.0 by: Randolph Constan, 1985. 
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If your printer is not an Epson y a few other characters may appear in the 
message (we will discuss this later). Also, if you forgot to hold down the OPTION 
key (for an XL/XE machine) or left a cartridge in the computer, the message: 
REMOVE CARTRIDGE! will appear on the screen, and the printer will do nothing at 
all. You will have to re-boot! If the title screen never appears, you may have a 
defective copy. However, there have been a few cases where a perfectly good S3DP 
disk would not load, due to misalignment in the disk drive. Unlike many programs, 
the S3DP must access it’s disk all the way to the innermost track, and this may 
show up a problem that was previously masked. Should such a problem occur, at 
least try cleaning your drive head(s) before suspecting the S3DP. If the title 
screen does appear, but the printer does not respond as indicated, check your 
cables, etc. and just hit SYSTEM RESET. At anytime during program operation, 
pressing RESET will return you to the title screen, and the program will again 
attempt to communicate with your printer, incidentally, the version number in the 
printed message indicates that improvements and/or modifications have been made 
to S3DP since the time of this writing. If any number other than 2.0 is printed, 
check the back of this manual for inserts covering the nature of the change. 


Note: If the S3DP cannot communicate with your printer during 
initialization, all future printer related commands will be ignored. 
You can re-initialize at any time with the RESET button, but this also 
clears the system of any "image data" currently in memory. For this 
reason, it is good practice to get the printer "up and running" at time 
of startup. The printer however is by no means essential to the program 
operation and can be ignored entirely if so desired. 

A few seconds after the title screen initialization, the MAIN MENU will appear. 
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1.3 MAIN 3D CONTROL, MENU 


When the main menu first appears, only two options are available. Later, 
when returning to the menu after using one of these, three more will be 
displayed. For now, please resist the temptation to select anything at all! 
First, let's get an overview of what all the options are: 

LOAD A 3D IMAGE : This selection is used to load a previously 
stored image file into memory. It also has the capability to merge a 
file with an image currently in memory. When "LOAD” is selected, a 
directory of image files is displayed, along with the message M ENTER 
FILENAME— D:". A few demos are included on your master S3DP disk. 
Note that this directory only lists image files, and is not a true 
indication of all files on the disk! For this reason, it makes sense to 
dedicate 'data disks’ for exclusive use with the S3DP. The LOAD option 
normally clears all image data currently in memory. However, if you 
enter your filename and hold down the OPTION key while you press 
RETURN, the selected file will be merged with any image currently in 
memory. This is a powerful feature and will be put to extensive use 
later on! If there is anything wrong with the disk, or the drive door 
is open, etc., the message "CAN*T ACCESS DISK/FILE" will appear and you 
will be returned to the main menu. Also, pressing RETURN with no entry 
will return you to the main menu without clearing memory. 

2- CREATE A NEW IMAGE: This selection unconditionally clears all 
current image related memory. A special INTERACTIVE GRAPHIC EDITOR is 
then entered, which will allow you to "draw" 3D images, right on the 
screen! If the OPTION key is held while selecting the CREATE function, 
an IMAGE DATA EDITOR is entered instead. All these utilities are fully 
described in Section III. After entering the GRAPHIC editor, pressing 
"Q" followed by RETURN will take you back to the main menu. To exit the 
DATA editor, press CTRL(Q) instead. 

Note: Throughout this manual, the letters "CTRL” mean that you are to hold down 
the "CONTROL" key while pressing the indicated key. Also, Please note that all 
requests for a FILENAME within the program demand the same criteria: Any 
combination of at least 1 and no more than 8 letters and numbers can be used, the 
first of which must be a letter. The " * " character can also be used as a 
wildcard as when using DOS. Always use uppercase (CAPITAL) letters and never n» 
extenders or periods. The "D:" you see displayed is just a reminder that you do 
not have to type in this prefix, as it is there already. Incidentally, extensive 
use of the sequence "hold down the OPTION key while pressing ..." has been used 
in this program. In the case of the RETURN key, this used to be a very convenient 
operation, easily accomplished with two fingers on one hand. However, since ATARI 
keeps moving the console keys every time they make a new machine, this operation 
is slightly more cumbersome on some models. Sorry 'bout that! 
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The following options will appear only when an actual image file exists in 
memory, due to correct usage of options 1 or 2: 

3- DISPLAY CURRENT IMAGE: Menu will disappear and your image wiD 
be displayed Refer to section n cf this manual for further details. To 
exit this mode and return to the main menu, press the START key. 

EDIT CURRENT IMAGEi Allows modification of an image stored in 
memory. As in menu item 2, the choice cf GRAPHIC or DATA editors is 
made by using the OPTION key, when you make this selection. 

5— SAVE CURRENT IMAGE! When this item is selected, the current 
image file directory is displayed, along with "ENTER — D:" prompt. 
Following you r ent ry, the S3DP will save your current image to the 
disk. Pressing RETURN with no entry cancels the SAVE operation. Do not 
be overly concerned with the disk space in terms cf sectors. Just note 
that an empty, formatted disk will hold up to 32 in»ge files depending 
on their length. This is because each stored image actually requires 2 
separate disk files. Since DOS 2 format only allows 64 directory 
entries, this entry capacity may be full, long before the actual disk 
space is exhausted. 


One final note: Never attempt to save anything to your master S3DP disk. 
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SECTION X X 


* * * Displaying your image! * * * 

I'm sure you're anxious to try the S3DP, so let's use it on a few demos and 
have some fun! Select item 1 (LOAD) on the main menu. When prompted for a 
filename, enter M PLANE2 M and press RETURN. This image originally appeared in the 
article "SOLID STATES" from A.NJLL.O.G. magazine, issue #16 (see APPENDIX II for 
info on converting "SOLID STATES" files for use with the S3DP!). The file will 
load, and you will be returned to the main menu with all 5 options now available. 
Select item 3. You will see the PLANE2 image at an angle which permits a 
reasonably full view. We will now discuss the effects of all available 3D 
functions and how to implement them. You may at this time wish to pull out the 
quick reference card (last page of manual) since this shows the logical grouping 
of all function keys, at a glance. 

2.1 CONSOLE KEYS: 

RESET: Returns you to the TITLE SCREEN, loads a printer control 
file from the current disk, and reinitializes the printer. If you 
have an EPSON or EPSON compatible printer, the master disk has 
already set you up for single density printouts. If you wish to 
change to double density (darker), or if your printer is not EPSON 
compatible, RESET will allow you to load in a "printer control" 
file of your own making. 

This is covered extensively in APPENDIX I. 

START: This key will return you to the main menu without 
disturbing your image. All motion is suspended. 

OPTION: Choice of graphic mode. Each press will step you through 
lo, medium and hi resolution modes. The S3DP initializes in medium 
resolution and will normally not change unless you change it. More 
color selection and faster animation is available in the low-res 
mode. More detail is available in hi-res. You can change at any 
time without effecting motion or screen dimensions. 

SELECT: Allows multiple color selections. In hi and medium-res 
mode, only "positive" and "negative" color is available. In 
medium-res, the colors you see are created by a process called 
artifacting, and can be sharpened substantially by adjusting the 
CONTRAST, COLOR LEVEL, and TINT controls of your TV. (For those of 
you familiar with artifacting, note that this is the only method 
of producing true color in single vertical lines, when a 
television is used as a monitor). In lo-res mode, SELECT can be 
used repeatedly to cycle the image through many line and 
background color changes, at the expense of detail. 
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2.2 ROTATIONAL DIRECTION CONTROL: 


The following functions are implemented using single keystrokes. All of 
these functions can be combined, but note that the keyboard cannot respond to two 
or more keys pressed together, except where specifically indicated. Try these 
functions now on the PLANE2 image. 


A,Z: Clockwise and counter clockwise rotation. Holding down the 
chosen key will increase the speed cf rotation, by widening the angle 
of change between screen updates. Pressing the alternate key will 
gradually decrease the speed, and eventually cause the rotation to 
reverse. Release the chosen key to maintain a steady rate. 


S,X: Vertical (up or down) rotation. When UP ("S" key) is chosen, 
it means that points on the image nearest to you, the viewer, wQl 
rotate upward. 


D,C: Horizontal (right or left) rotation. When "D" is selected, 
the nearest part of the image will turn to the right. 


Q,W,E: Instant "freeze” controls for each of the rotations above. 
The reference card shows that each "freeze" key is located directly 
above its corresponding direction keys. 


Note that all rotations work completely independent of each other. Any complex 
rotation pattern desired can easily be set up, by carefully combining these 
functions, but it will take some practice. Remember however that only one key at 
a time can be pressed. Also, the rotational accuracy of the current S3DP is 
vastly superior to the earlier version 1. However, if complex rotation at the 
faster speeds is used for an extended period of time, distortion will eventually 
begin to show up in the image. To remedy this, simply return to the main menu, 
and re-load the image. 
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2.3 ROTATIONAL, OFFSET CONTROL: 


We are now approaching the point where a picture is definitely worth a 
thousand words. In order to simplify our discussion, take a look at the 
illustration in figure 1. (below). The three possible dimensions are represented 
by X,Y, and Z. For our purposes, X will always refer to the horizontal dimension, 
with positive motion always being to the RIGHT. Y in turn, will describe 
vertical motion and UP will always be considered positive. In the case of depth, 
Z will represent our direction, with positive motion always being AWAY from us. 
Referring to the figure, Clockwise rotation can now be easily represented as X/Y 
rotation, around a stationary Z axis. All three rotational possibilities can also 
be described in a similar manner. At this point, it would be worthwhile to return 
to the mein menu, and load in the image called "CUBE”. A cube is a very easy 
object to visualize. Learning to use the rotational DIRECTION controls in 
combination with the OFFSET controls we are about to discuss, will be much easier 
with this image. 



Figure 1. All motion can be described in terms of X.Y. and Z 
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ROTATIONAL OFFSET cont* 


Please notice that in all cases, the ROTATION DIRECTION controls cause 
rotation around a central "zero” axis. By altering the ROTATIONAL OFFSET with the 
following controls, the object can be made to rotate around a different center. 
In fact, by facing the PLANE in the proper direction, and moving it far enough 
from its original axis, the PLANE can be made to "fly" in a circular path instead 
of rotating around its own center. This of course will require some experience at 
operating these controls, so work with the CUBE for a while to get the "feel" of 
it, and don't be afraid to experiment. 

K, The "K" and comma (,) keys control positive and negative 

Horizontal (or X axis) offset The longer you hold down a key, the faster the 
object will accelerate in the chosen direction. Pressing the alternate key will 
gradually decrease the speed, and eventually cause the motion 
to reverse. Release the chosen key to maintain a steady velocity. Rotational 
offset controls are completely independent of each other, and of any rotation 
currently in effect. 

L. The "LV and period (.) keys control positive and negative 

vertical (or Y axis) offset Functionally, these are identical to the above, but 
in the up-down direction. 

;/ The semicolon (;) and slash (/) keys are for positive and 

negative "depth" (or Z axis) offset control. Seme as above but in the direction 
toward and away from you. Z offset centred is a bit more difficult to handle 
s i nce movement along this axis is not directly visible, except for changes in 
perspective. 

I,0,P Instant "freeze" controls for each of the offset controls 
above. Again each freeze key is located directly above its* 
corresponding OFFSET pair. 


All the above assu m es you are viewing an object at some specified distance. 
In the opposite case where you are inside an environment you create (such as a 
street with houses on both sides), The viewer distance would be zero! Then, the 
ROTATIONAL OFFSETS would be used to move you through the image. I know this must 
all sound confusing, but in time it will become instinctive. Continue to 
experiment with the cube, keeping your reference sheet nearby. When you feel 
reasonably satisfied that you have a basic understanding of how the rotational 
OFFSET and DIRECTION controls interact, proceed to the next paragraph for a more 
complex demo. 
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ROTATIONAL OFF-SET cont* 


To see a good example of how the rotational controls operate from inside an 
environment, return to the main menu (START key) and load in the filename 
TIEFIGHT". This is another image from ANALOG magazine. It is a spaceship from 
the movie "STARWARS". After it has loaded in, use option 3 to display the image. 
This is an extremely complex image consisting of many lines and points, and the 
motion will unfortunately be much more sluggish. Now, to get inside the 
spaceship, let’s discuss two more controls at your disposal: 

2.4 VIEWER DISTANCE & MAGNIFICATION: 


G,H: The "G" and "H" keys control positive and negative 

VIEWER DISTANCE , respectively. The "G" key moves an object further 
away, and the "H" key moves it closer. (This should not be confused 
with Z axis offset, since the distance controls move both the object 
and its center axis simultaneously). As you move the object closer, it 
will not only enlarge, but as in the real world, its perspective will 
get more "drastic”. TEEFlGHTer is a very large object, and the effect 
of perspective may make it difficult to really visualize its’ 
appearance at close distances. This is where magnification comes in. 


B,N: As in the real world, viewing a large object at 

a long distance with a telescope causes the effect of perspective to be 
diminished. In many cases, the size of an object does not permit the 
view desired, because the perspective is to exaggerated. You can adjust 
this to your liking with the "B" and "N" keys for positive and negative 
MAGNIFICATION . Ehch time you press the "B" key, your image will be 
magnified by a factor of 2. Conversely, the "N" key will remove 
magnification by the same factor. Note that as with a real telescope, 
magnification has a much greater effect on distant objects. 


By using the Magnification and Viewer distance controls together, it should 
be possible to obtain any perspective view and size desired. 8 stages of x2 
magnification are available. The VIEWER DISTANCE controls however, are 
proportional in operation. That is, the closer you get to an object, the slower 
it will seem to move toward you, and the opposite will occur as you move further 
away. 
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<> 

VIEWER DIST. & MAG. cont*. 


If you have loaded the TTEFTGHTTer image as directed, press the "H" key now and 
keep holding it down. As mentioned earlier, the TIEFIGHTer is a very complex 
image consisting of 136 drawn lines! This complexity will generally cause the 
motion to be slower, but eventually you will find yourself in the center of the 
huge craft. When you reach the center, all motion will cease. Now press the "D" 
key and the object will begin to rotate. Continue this rotation until you find 
yourself looking straight down the side section of the spaceship, toward its 
large fin. Press the "E" key to stop the rotation. 


As you can see, when you are at zero viewer distance, the object or world 
seems to rotate around you. This is because the axis of rotation and your TV 
"window" cure at approximately the same point in space. If you now press the "/" 
key, to move the Z ROTATIONAL OFFSET, It will appear as though you are moving 
through the ship! If you come out through the end of the image, press the "P" key 
to stop the motion, And turn around using the "D" key. Eventually, you will see 
the ship swing back around in front of you. Can you see how the meaning of 
ROTATIONAL OFFSET has changed as a result of you being in the center? At this 
point, why not experiment for a while. Re-trace your steps if you got lost during 
this demo and try some ideas of your own. Try to load in the PLANE2 image and 
make it "fly" in a circle as suggested earlier. You'll find that the PLANE 
responds faster too, since it contains fewer drawn lines. The TIEFIGHTer however, 
is much more interesting from the inside view. Again, it is sometimes useful to 
work with the CUBE to get the feel of the controls, and remember you can switch 
graphic modes to speed up the motion or increase detail as you see fit. 
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HIDDEN SURFACE ELIMINATION: 


Before utilizing this function, some technical program information is in 
order. The images displayed by the S3DP consist of points in "space” and lines 
connecting them. These points and lines are maintained in data tables within the 
computers memory. What is commonly called "hidden line elimination" is the effect 
caused by one surface partially or completely blocking another from view. In 
order to accomplish this task, the line data in memory must be laid out in a 
specific manner, such that the S3DP "knows" where each surface begins and ends. 
This will be covered in more detail in section III. For now, the important thing 
to note is that images created specifically for a hidden surface view can be 
displayed with or without this function turned on. Images prepared without this 

special format will show no difference . Return now to the main menu, and load and 
display the image called "SBOX”, in medium resolution mode. 


(CTRL)S: HIDDEN SURFACE TOGGLE. The (CTRL) S combination will turn on 
the hidden surface function. Repeating the (CTRL) S combination will 
turn it cff. If the "SBOX" image is being displayed as directed, press 
the "A” key to start it turning. Notice that the motion is a bit slower 
and "jerkier" then the CUBE image, even though we have not yet 
implemented the hidden surface function. This is the trade off 
resulting from the special data format we mentioned earlier. Now, hit 
(CTRL) S. If the image looks the same (except for the drastic 
slowdown), it's because you’re looking into the "open” side of the 
"BOX". Add some vertical rotation (S key) and you will soon see that 
the image really is a box , with all but one side open! Despite the 
annoying slowdown, this is a very impressive simulation. Normally 
though, you will position your object to the view desired before 
turning on ’hidden surface 1 , to avoid some of this delay. But wait.. 
There’s more!... ’don’t touch that dial!’... 


(SHIFT)S: SURFACE COLOR FILL. With the "SBOX" image still rotating 
on the screen, and hidden surface enabled, hit (SHIFT) S. Your screen 
will light up as each side of the box fills with solid color! (hitting 
(SHIFT) S a second time disables the color fill option). 

NOTE: Toggling the hidden surface function off also turns off the color fill 
option, and switching graphic modes turns off both of these. You can use the 
hidden surface and color fill functions in any resolution mode, but you’ll find 
that "edge" detail suffers when COLOR FILL is used with Hi-Res. Also note, that 
as of this writing, both of these functions are not very tolerant of partially 
offscreen surfaces, and may occasionally produce broken lines and random color 
"smearing" when an object gets too large for the screen. Some experimentation 
wiU quickly reveal what these limits are, and how to get the most from the 
system. Also, surface ’priorities’ can be altered by pressing the 1,2 or 3 keys 
while the display is active. This will be fully explained in section III. 
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MISCELLANEOUS CONTROLS 


T: EXCLUSIVE OR (XOR) DRAWING . In hi-res mode only, the "T" key toggles the S3DP 
between "OR" and "XOR" drawing modes. This means that when two lines cross, the 
point of intersection will be dark (background color) in XOR mode, and Tit* 
(foreground color) in OR mode. This can sometimes be used to clarify points of 
intersection in complex images. It can however cause confusing displays since two 
lines drawn directly over each other in XOR mode may not show up at all! A few 
moments of experimentation will quickly reveal its* subtle effect. Also, when 
used in conjunction with the Y key described below, some interesting and colorful 
effects can be generated. 

Y: ERASE TOGGLE . The S3DP maintains 2 screens in memory at all times. At any 
given moment, the one you don’t see is the one currently being erased and 
re-drawn. Pressing the "Y" key turns off the erasing between screen updates. When 
you become proficient at designing 3D images, you will find this function to be a 
useful aid in positioning image files as they are merged together. Aside from 
this, it also allows some very interesting computer art effects. Load in the CUBE 
file, display it in medium-res mode, and back it off ("G" key) until it’s about 
the size of a dime. Press the "A" key to start it rotating, then the "Y" key to 
turn off screen erasing. Now, hold down the "H" key to slowly zoom into the 
image. Pretty dazzling I dare say! Press Y again to resume normal display. Try 
this procedure again in lo-res, or in combination with the XOR drawing option in 
hi-res. Too bad you can’t save this display somehow. Or can you? 


(SHIFT/CTRL) T : SCREEN SAVE . This function is intentionally made difficult to 
execute since it takes up a lot of disk space (62 sectors). Hitting this sequence 
of keys will save the entire screen (hi or medium res. only) to a disk file 
called "PICTURE". This file is MICROPAINTER compatible and can be leaded into 
most drawing programs easily. Also, any programs you may have that dump one of 
these pictures to a printer can directly use this File. 

(SHIFT/CTRL) Y : SCREEN OVERLAY . This function does the opposite of 
(SHIFT/CTRL) Y. It searches the disk currently in the drive for a file called 
"PICTURE". If successful, the file will be copied to the screen, and your image 
will be displayed along with it! When the process is complete, the S3DP 
automatically switches off the SCREEN ERASE function, so that the image is 
retained. Your S3DP master disk contains a very interesting ’PICTURE’ file, 
should you wish to try this function now! To restore the screen to normal, toggle 
the screen erase back on with the Y key. This is an extremely powerful tool, 
since any image can be saved as a "PICTURE", and any "PICTURE" can be used as a 
background overlay. The possibilities are endless! 


Note: The image file directory that appears during SAVE and LOAD operations does 
not indicate the existence of a ’PICTURE’ file. For this reason, always record 
the existence of such files on the labels of your data disks. 
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2.7 IMAGE PRINTOUT FUNCTIONS! 


If you do not have an EPSON printer with GRAFTRAX PLUS (or an EPSON 
compatible printer), you must refer to appendix I of this manual for instructions 
before attempting this function. Assuming your printer is ready, compatible, 
etc., you are now prepared to make a printout. Again, let’s learn by example. Go 
back to the main menu and load in the "PLANE2" image. Display the image, and make 
sure you are in the highest resolution mode . Now, try each of the following 
functions. 


(SHIFT/CTRL) P : This key combination initiates the SUPER HI-RES 
FTONTQUT Don’t panic when you see the screen gp NUTS ! Here’s what is 
happening: First, the screen was expended by a factor of x2 in all 
directions. The picture now takes up 4 screens. As you watch, the 
program will begin scanning these screens two at a time, leaving trails 
of "negative” picture behind. Depending on how much your 
picture filled up the original screen, you may or may not see anything 
on the printer yet. When the first pair of screens are completed, the 
next two are brought up and scanned. 

Keep watching (the multiple images are displayed to give ycu a hint cf 
what’s going on rather than stare at a blank screen). Note that the use 
of this printout is restricted to HI-RES screens, with the HIDDEN 

SURFACE function off, and normal ’SCREEN ERASE’ active . 

If any cf these criteria are net met, the QUICK SCREEN DUMP described 
below will be automatically selected. 


NOTE : If the printout is going well, just be patient - printers are slow when it 
comes to graphics. If your printer is displaying characters or just plain 
garbage, press the S FAQ E BAR to abort the printout , 
and skip the next function for now. 


(CTRL) P : QUICK SCREEN DUMP . This printout is not as dramatic as 
the last one, but it’s very fast. Also, this printout has fewer 
restrictions. The QUICK DUMP can be used at any time, in any graphics 
mode except ’lo-ree’ (who wants a ’lo-ree’ printout anyway!). Note that 
if the SCREEN ERASE is c£f, the printout should always be allowed to 
run to completion. Otherwise, some bizarre screen flashing will occur 
until ’ERASE’ is turned back on! 
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PRINTOUTS cont.» 


If all went well, examine the PRINTOUTS. The image made by the SUPER HI 
option is equivalent in detail to one made by a more powerful graphics computer. 
Your S3DP hi-res screen has a resolution of 320 x 192 pixels. The SUPER HI 
printout however, has a total resolution of 640 x 384 dots (count em!), through 
the use of this multi-screen method. Unfortunately, producing this dramatic 
"plotter" effect requires that the screen image be expanded, re-positioned, and 
re-drawn many times, with all this re-drawing, something called "integer 
truncation" (in the offscreen line clipping routines) causes errors to 
accumulate. Because of this, the final printout may at times contain a few broken 
or missing line sections. If this occurs, move, rotate, or backup the image 
slightly and try again. A small change in the image position can make the 
difference between perfection and broken lines. If during a printout, you spot 
what you would consider an intolerable error, you can abort the printout at any 
time by pressing the SPACE BAR The QUICK DUMP option only uses one screen, so 
these problems never occur. 


NOTE : If you have had no success at all with any of the printouts so far, it is 
likely that one of the following is the cause: 


a) The printer is not completely EPSON compatible, and you 
will need to load in a new PRINTER CONTROL FILE as instructed 
in appendix I. 


b) You made an error in creating your PRINTER CONTROL FILE. 


c) If nothing happened at all when you attempted the 
printout either the printer was not on line, it did not 
initialize properly during power-up (or RESET), or the screen 
image was in lo-res mode when you attempted this function. 

d) The printer is EPSON compatible and somehow, the PRINTER 
CONTROL FILE on your master S3DP disk has been damaged. Refer 
to appendix I for information on creating a new one. 


-* * * CONCLUSION ***- 

The S3DP can display your creations from any angle, view, or perspective 
imaginable. Controlling the animation will however take some practice. Keep at 
it, and in no time you'll be moving your images about without even referring to 
the manual or reference page. Then, you're really flying!! 
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SECTION XXX 

**** CREATING YOXLJR IMAGES * * * * 

THEORY: 


As we have seen, the images displayed by the S3DP consist of 'points* in 
space, and 'lines' connecting them. The process of using a computer to create 
such images is generally called Computer Assisted Design (CAD). While the S3DP 
does not perform all the functions of a $10,000 CAD workstation, it does provide 
many of the basic tools. To create images effectively however, we must obtain a 
basic understanding of how an object is converted to 'points' and 'lines', and 
how this 'data' is maintained by the program. This will help us maximize the 
usefulness of the tools provided! As such, this is the longest section in the 
manual and should be read through thoroughly; even if you already have an 
understanding of the concepts involved. This section is divided into 5 parts. In 
the first, we will create a simple 3D image of a hollowed out cube with pencil 
and paper only, to learn the principals of measuring in X,Y,Z coordinates. In 
part 2 we will repeat the process using only the S3DP INTERACTIVE GRAPHIC EDITOR 
In part 3, we will learn about the IMAGE DATA EDITOR, and how it can help us in 
preparing and/or altering an image. Part 4 provides a thorough cross reference, 
explaining the uses and effects of all of the functions provided, in both 
editors. You may need to refer to this section from time to time to correct 
errors, if and when they occur. Finally, part 5 deals with HIDDEN SURFACE 
ELIMINATION, and the use of special effects such as file MERGING and SCREEN 
OVERLAYS, to aid the advanced designer in creating images faster and more 
efficiently. 


Each "chapter” within this section is reasonably complete. So, if you 
already understand the principals of laying out X,Y, and Z space coordinates for 
the points and lines that make up a 3D image, you can probably skim over part 1 
and concentrate on learning the use of the S3DP design tools. If you think 
however, that laying out space coordinates means deciding what outfit to wear on 
a trip to the moon, read on! 
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3 - 1 Pencil and PAPER 


Representing an image with points and lines is very similar to measuring an 
object to obtain its* width, height, and depth, but with two important 
exceptions: 


a) Normally when we take measurements, we can change our reference 
paints at wilL For example, we can say that an object is 8 inches from 
top to bottom, without regard for which end represents our starting 
pcint. When defining an object for the S3DP, we must separately measure 
each end, with respect to a pre-determined reference (usually the 
center), and consistently maintain the same reference for all 
measurements. 


b) To design a symmetrical image like a cube, you would normally 
expect that three measurements are sufficient. You must remember though 
that unlike a computer, you can think and remember what a cube looks 
like. Consider how impossible your task would be, if you were told to 
draw an object, given its* width, height, and depth, without having the 
foggiest idea what the object was! So, to properly define the cube for 
the S3DP, we must provide 3 measurements for each of the 8 corners 
(points), and then instruct the program to connect these points with 
straight lines. 


Representing an object this way will seem a bit tedious the first time you 
try it, so we'll use a relatively simple object to get a feel for the concepts 
involved. In many cases, the tools provided by the S3DP GRAPHIC and DATA editors 
almost eliminate the need for pencil and paper. For any precision representation 
of a "real life" object however, some carefully prepared sketches (preferably on 
graph paper) are a near necessity. Also, even for 'fun' type images where 
precision is unimportant, you'll find a few sketches very helpful in making 
future modifications to your work. This will become clearer as we continue. Now, 
examine the sample drawings on the next 2 pages. 
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3.1 Pencil and paper, con’t. 


The preceding pages show four commonly used methods of representing a three 
dimensional object on paper. Method 1 simply shows the object from 3 views,? each 
at right angles to the other. For the hollowed out cube shown in the example, 
this almost seems silly. However, this is the very type of drawing a draftsman 
would present to a modelmaker, for actual construction. It is the only method 
which allows direct and accurate measurements of all three dimensions, right on 
the paper ! With method 2, the 30 degree angles in the X and Z dimensions make the 
drawing more realistic visually, but this also causes distortion which disallows 
direct measurements. Method 3 has the advantage of allowing at least two direct 
measurements of X and Y, but again, the Z measurement would have to be done 
instinctively. While this is relatively easy for a cube, a more complex object 
might not be so tolerant of guesswork. Method 4 is a perspective view in which 
all three dimensions are "projected" from one of three reference points. This 
method is very visually accurate and is difficult to draw, especially in a more 
complex image. 

This in fact, is exactly what the S3DP does! Later, you will see why drawing the 
image directly on screen would be nearly impossible, if perspective were not 
turned off! With a perspective view, true measurements of any kind would be out 
of the question. Since I cannot possibly present a full course on mechanical 
drafting here, I would suggest you use method 1 for all final measurements. Try 
to obtain some finely ruled graph paper, as this will make the job as easy as 
counting squares. 


Below is a step by step procedure, for laying out an object. I recommend you try 
it with the "hollowed out cube" example now, for practice. 


a) Make a few sketches similar to methods 2 or 3 first, to clarify 
the design in your mind. Do this even when you have an actual model 
since you'll need a visual reference when making your measurements. 


b) Carefully draw your three views as shown in method 1. Use the 
largest paper available. Make sure the three views are lined up so that 
paints that are common to more than one view, can be connected by 
straight, dotted lines. The use of different colored pencils for 
reference and measurement lines is strongly recommended. 
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c) When the drawings are complete, begin your measurements. 
These measurements should be taken for each "point" where one or more 
lines come to an end (such as corners). Refer to your full view sketch 
to check for points which may be hidden in your 3 view drawings. Each 
point should have three measurements, representing the respective 
distances, from the X, Y, and Z reference lines. Remember that all 
measurements must be made perpendicular (at right angles) to the 
reference lines. Also, note that since our reference lines are at the 
center, some of your measurements should contain negative values. 

d) The S3DP can accept your measurements in the range of about -32000 
but, no decimals will be allowed. It is therefore advisable to 
take measurements in the smallest increment possible (say 1/16 inch), 
to give the program larger numbers to work with. Actually, 1/16 inch 
corresponds closely to the minimum size that can be displayed, given 
the size of a hi-res graphics pixel. 

e) Number your points as you proceed, and organize your measurements 
in a table as shown. Notice how the points were numbered in method 2. 
Since the object in this case is perfectly symmetrical, this view was 
needed to reveal those paints which are completely hidden in the 3 view 
drawings. 


f) Although no curves are involved in this example, it should be 
curves must be broken down to a series of straight lines for 
the S3DP. 

The hollowed out cube was scaled down to fit in the manual. In your actual 
drawing, the outside should be 5 inches for all outside dimensions, and the 
inside tunnel 2.5 inches square. Since the center is the reference, 5 inches 
translates into + 2.5 inches. This was then converted to 1/16 inches, to yield 
the + 40 values shown. Definitely try to get this example right, or at least 
understand how the values were obtained before attempting a more complex object. 


THE X Y 2 POINT DATA FOR THE 
HOLLOWED OUT CUBE 18 LISTED. 
BE SURE YOU UNDERSTAND HOW 
THESE RESULTS WERE OBTAINED! 



POINT 

DATA 


No. 

Xpos. 

Ypot. 

Zpoft, 

T“" 


‘"W” 


2 

40 

40 

-40 

3 

40 

-40 

-40 

4 

-40 

-40 

-40 

5 

-40 

40 

40 

6 

40 

40 

40 

7 

40 

-40 

40 

6 

-40 

-40 

40 

9 

-20 

20 

-40 

10 

20 

20 

-40 

11 

20 

-20 

-40 

12 

-20 

-20 

-40 

13 

-20 

20 

40 

14 

20 

20 

40 

15 

20 

-20 

40 

16 

-20 

-20 

40 
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Pencil and Paper, cont*: 


Assuming you have successfully measured out the point data for this or 
another object, there’s one last thing left to do: Multiply all your data by 10! . 
In other words, a point at X=-40, Y=+40, Z=+40 should now be -400... etc. There 
are two reasons for this: 


a) The S3DP uses integer math. This means that as far as the 
program is concerned, there is no middle ground between, say, 40 and 
41. Giving the program more digits to work with will therefore increase 
its* display accuracy, especially at dose views. This of course will 
give you better control over perspective. Since there is also a limit 
to the maximum size object the S3DP can handle, making the object too 
large will also limit the maximum viewer distance you can obtain. To 
maximize control over the effects of both viewer distance and 
perspective, a good rule cf thumb is that the longest dimension be in 
the range cf + 200 to + 2000 and the shortest dimension be no less than 
± 20. This is not a hard fast rule, just a guideline. If you were 
designing a "world" instead of an object for example, it might be 
better to use a maximum dimension of + 10000. In any event, its a 
simple matter to multiply the data by 10 (or even 100) to obtain the 
optimum range. 


b) Again, as far as the S3DP is concerned, there is no middle 
ground between 40 and 4L Therefore, using a value of 400 insteed will 
allow you the flexibility cf making a change to say, 406, where 40.5 
would have been impossible. Refer to section IV of this manual for more 
details on maximum range, etc. 


If you’ve followed this example through, you now have a good understanding 
of what is needed, to translate simple measurements into "space coordinates." 
Following this principal, you could easily take an actual blueprint of any 
object, and translate its’ measurements for use with the S3DP. As we'll see in 
our future discussion of the DATA editor, adding lines to the points is 'snap'! 
Tip: If you have an actual model, you can easily use a parallel light source 
(such as sunlight), to trace out shadows for the three views necessary. 

Now, let's turn our attention to some of the powerful tools available for 
creating graphic images, right on the screen!. 

****next point data goes here*** 
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3.2 INTERACTIVE GRAPHIC EDITOR • 


Prepare at least one formatted (DOS 2) data disk if you have not done so 
already. Keep your sketch of the hollowed out cube nearby and 'boot up' your 
S3DP. If you did not make a sketch or measurement table, just refer to example in 
our previous discussion. Later, you'll see how sketches and measurements can be a 
welcome aid, even in the simplest image designs. Select main menu item 2 to 
'CREATE A NEW IMAGE'. This is the S3DP GRAPHIC EDITOR. Using it is simplicity 
itself. Plug a joystick into PORT 1 , and let's begin. Rather than list all the 
individual functions available, we will discuss the overall operation of the 
editor, and the logical sequence necessary to enter the hollowed out cube 
example. Later in part 4, we'll go into more depth, and cover all of the 
functions provided. 

MODE SCREEN 


As you can see, the screen is now divided into a GRAPHIC and TEXT window. 
The highlighted word MODE? tells us that the editor is ready to accept 
our next command. 

The three basic modes of operation employed by the editor are:- 
POSITION, ADD and, EDIT. 

Each mode has several available functions, and the MODE? select screen 
operates as a menu and return point for all of these. You will always be returned 
to this screen whenever any operation (or series of operations) is complete. 

The "P =000" and m L = OOO m indicators 
show you the current total number of points and lines entered. Since we entered 
the editor with the "CREATE" option from the main menu, all image related memory 
was cleared; hence the zeros. The -1200,0, and +1200 at the far left, right and 
center of the screen indicate the current scaling, (note that the zero is not 
really positioned at the 'exact' center of the screen). 

OPTION SELECTION 

Notice the "*" symbol next to the ADD mode option. Anytime options of 
any kind are displayed, typing the first letter of the selection (ex: "A" for 
ADD) will activate that option. However, the Graphic Editor was designed to 
eliminate, as much as possible, the need to access the keyboard. So, whenever 
options are displayed, pressing the FIRE button on the joystick will 
automatically select the option alongside the "*" symboL If a different option 
is desired, move the Joystick to the RIGHT momentarily. Each RIGHT movement will 
move the "*" symbol to the next available option, and allow you to select it 
with the joystick FIRE button! This convenient feature will drastically cut down 
on the need for keyboard entry, and in many cases, multiple operations can be 
performed without ever touching the keyboard! 
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Graphic Editor, cont* 
ADD MODE 


Right now, the ADD mode is what we want. Since the * symbol is already 
.next to this option, just ’click’ the FIRE button to enter this mode. You will 
see the word ADD highlighted, and a cursor in the center of the screen. As you 
move the joystick, your relative position is continuously displayed on the right 
side of the text window. Also, notice that the "Z" coordinate does not change 
while moving the joystick. 

Note : an optional slow speed cursor mode can be implemented by 
hitting the "S" key, whenever the cursor appears on the screen. Hitting 
the SPACE BAR (cr any other key) returns the cursor to fast mode. You 
will probably need this feature often at first, but with practice (and 
a decent quality joystick) you may never need it at aH Fbr now, feel 
free to use this slow speed mode anytime during our discussion. 

Now, with the ’hollowed out cube’ data in front of you, move the cursor to the 
first X,Y coordinate, which is -400X and +400Y (remember we agreed to multiply 
our data by 10!). When the cursor is positioned correctly, ’click’ the joystick 
button once. 

The options "Keep point" and "Retry" will appear. 
There are a number of reasons why you might wish to ’re-try’, the most obvious 
being if you failed to accurately position the cursor. If the cursor position 
indicator does not show X=-400 and Y=+400, move the joystick to the right to 
select the retry option, click the FIRE button, and continue positioning. When 
you’ve ’clicked* the cursor in the correct location, select the "Keei? 
jpoirxt" option. You will now be asked to enter a "Z" value. 
The Z value for our first point is -400. Enter this value through the keyboard, 
and use either the RETURN key or the fire button to complete your entry. 
You will now be given the options:- 

"Extend line," or "Esc to abort” 

(the highlighted "Esc" always refers to the escape key). We want to extend a 
line, and the "*" symbol is already next to that option, so click the fire 
button to select it. You are now asked to enter a "line color*". Line 
colors (and surface colors incidentally) can be 0 to 3, with 0 being the 
background or no color. Normally when designing an image, we are much more 
interested in shape than color, so just click the fire button to accept the 
default. Colors can easily be changed later as well see. Now you are asked:- 
"Start Surface? <*N/ Y)". 

’Click* to accept the default which is no! Surfaces will be discussed later since 
they require a special format of line construction. Now, move the cursor, and a 
line will automatically extend from your first point of origin to the new cursor 
location. This function is similar to many "touch tablet" type drawing programs. 
A joystick however has the advantage of keeping the cursor position steady when 
you put it down. Move the cursor to the next X,Y location on our list. This is 
X=+400 and Y=+400, and again, use the "S" key to slow things down if you have 
trouble. When in position, ’click’ once to freeze the cursor, and again to Keep 
the point. This time, when you are asked to "Enter* Z.", 
just ’click* the joystick button with no entry. 
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Graphic Editor, cont* 


Note: A single RETURN or FIRE button 'click* for the Z entry always 
selects the previously entered Z as the default value. As you can see by the 
cursor data in the Text Window, the "Z=-400" is still active. This feature 
eliminates the need for accessing the keyboard, when entering multiple points and 
lines on a single Z plane. 

After 'clicking* in the default Z, 'click' once again for the "Extend 
line" option, (notice that the "Esc" option now says "Esc to exit " rather 
than "Esc to ' abort '"). Upon making this entry, your cursor will immediately 
become active. 'Line color' and 'surface start* entries are only required the 
first time you extend a line, in an ADD operation. Move this time to X=+400, 
Y=-400. Keep up this procedure until the first 4 points, and 3 complete lines 
have been entered. 

LINKING 

Now, to complete the "square",extend the final line from the last point you 
entered (which should have been X=-400, Y=-400), back to the starting point of 
X=-400, Y=+400. When the cursor is correctly positioned, 'click' the FIRE button. 
If the message "Kee p point" or "Retry" appears, 
select Retry ! Your cursor was not positioned properly. When you 'click' the 
cursor exactly at the indicated position, you should see: 


Point: Alreaxiy exists at, : X=-400 

Y=+400 

Options : Link -to old, Add new Z=-400 

Esc lo exit. 


You see, everytime you 'click' the cursor, the S3DP reports the existence of 
a point already at that X,Y location (regardless of Z). Since we want to connect 
our line back to the Start point, the message "Keep) point/ 
Ketr-y" would indicate that we missed the mark! If you've successfully 
'clicked' the cursor in the right position, move the "*" symbol to the Esc" 
option, even though the position is correct . This time, try to center the cursor 
at the exact location, without looking at the cursor position indicators . This is 
tricky and you will probably have to select " Retry " several times before you get 
the "Point Already exists..." message. However, with 
practice and occasional use of the "S" key, it will become second nature. 

When you've successfully 'clicked' the cursor at the right location, 'Click' 
again to select the "Link to old" option. Now, when asked to 
"Extend line" or "Esc to exit", move the "*" to the 
"Esc" option and 'click*. You will then be returned to the "MODE?” helect 
screen. 
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Graphic Editor, eont* 


At this point, you could use the "Quit" option to return to the main 
menu, and SAVE what youVe done so far. Just be sure to use the data disk you 
prepared earlier, and not the master S3DP. As in any computer work, saving often 
makes good sense, and in this case it only takes a few seconds! Be sure to use a 
different filename each time you save, so that you can re-load and change errors 
if they occur. Also, Never Rotate or re-position an image in any way until you’ve 
saved a copy of the original ! You’ll see why later. 

Now select the "ADD" mode again. What we want to do is enter the 
next 4 points on our list (5-8), and once again extend a line between each 
successive point. Those of you familiar with CAD type systems probably have noted 
that since these points are identical to the previous 4 (except for the Z 
values), there should be some quick and easy way to accomplish this. There is 
such a shortcut available, but let’s stick with the ”standard” Editor features 
for now since there are a few important details I want you to see. The first 
point to be entered is #5, at X=-400, Y=+400, Z=+400. Again we will enter these 
points and extend lines to form a square, but there will be one major difference 
this time around! Whenever a point is ’clicked’ in at the proper location, the 
Editor will report that such a point already exists, but at Z=-400. 
You must always remember to choose the "Acid new" 

rather than the "Link to old" option ! 

Also, in your first point entry, you will have to enter the new default Z of 
+400. Do this now with points 5 through 8. Remember you are starting at the upper 
left. Since you are drawing lines over existing lines, it’s easy to forget where 
you started. 


Note : When drawing lines directly over other lines, both will 
disappear when the cursor is ’clicked’. This is just an indication that 
both lines are actually on the same "track". As the entry process is 
complete for each line, it will re-appear. 

When all 4 points have been added, and you click the cursor to complete 
the final line back to point 5, again you are asked; "Link; to 
old", or "Acid new". If you’ve done everything as described so far, 
you chose the "Add new" option the last 4 times, but what about,now? 
Think about it; you do want to link to an old point, but which one ? When you 
started the second square, you entered a new point at X=-400, Y=+400, but there 
is also point #1 at the same X,Y location (at Z=-400). Which one are we going to 
link with? The answer is in the text screen! Whenever the message: "Point already 
exists at: .... " appears, the X,Y, and Z values displayed are the actual data 
from the point in question, rather than the cursor and ’default Z’ data. So, 
since the text window shows the point ’found’ at Z=+400, we know we have the 
correct point and can go ahead with the "Link" option! 

Note : How did the Graphic Editor "know" which point we wanted? When 
multiple points exist at the same X,Y screen location, The editor 
always picks the last one entered for the "point exists..." message. As 
in the case above, this works out for the best in most instances. 
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Graphic Editor, coin t * 


POSITION MODE 


At this point, we have created enough points to form a complete cube. If you 
want to complete the original image however, repeat the entire procedure with 
points 9 through 16. Everything will be identical, except that you are now 
working with +200 for X and Y values. Remember to put in the proper Z values at 
the start of each ’square*, and never use the "Link" option until each square 
is complete. 

In either case, SAVE the image again with a different filename. After the 
save, come back to the Graphic Editor with main menu item 4. 
Entering the editor with an image in memory causes us to go directly to the 

"POSITION" mode rather than the "MODE?” menu. 

We have now completed as much as we can without moving the object! In order to 
complete the remaining lines, we must now re-POSITION the image so that all the 
endpoints are plainly visible. The "POSITION" mode allows us to do just 
that! 


Touch the "S" key for a moment to rotate your image ’upward*, then the ”W” 
key to stop. Now, momentarily touch the "D" key to rotate slightly to the 
’right*, and hit the "E" key to stop. If you entered the entire image correctly 
so far, it should look something like this: 


OR 



If your image looks different, you probably made an error somewhere along 
the line. If that’s the case, see if by looking at the image you can tell what 
went wrong. Did you enter new *Z* values at the beginning of each square? Did you 
"Link when you should have "Added”? Don’t worry about it. My first f cube 
looked like a pretzel, and I wrote the program! If the image looks correct, 
congratulations! If not, there are several ways to correct errors, but the 
important thing now is to learn to ’get around’ the Editor. So let’s continue and 
ignore them for now. 
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Graphic Editor, cont* 


In the current "POSITION" mode, control is returned to the 
keyboard. All Rotation and Rotational Offset controls work exactly as in the 
main menu display mode. On your reference card, note that all functions that do 
operate in the "POSITION" mode are marked with a "*" SYMBOL. 
The *B’ and *N' keys however, control SCALE instead of magnification. Try the B 
and N keys now and notice how the size of the image changes along with the aral* 
values at either end of the TEXT WINDOW. 


Note : The rotation and offset controls will seem to respond much 
faster than in the display mode. This is irarinly due to the fact that 
the perspective calculation has been bypassed! Also, note that it is 
sometimes difficult to distinguish the 'back' and 'front* of an image 
without this perspective, but you'll get used to it Just remember that 
the 'S' key rotates the front of your inage upward , and the *D' key 
rotates the front to the right . 


When you have positioned the image so that to your satisfaction, all the 
endpoints of the image are clearly visible, hit the "Esc " key. 
Now we're back in the familiar "NODE?" menu.Select 
"ADD" and proceed to connect the appropriate endpoints with lines. In this 
case, you must "Link" to each endpoint when you start and end a line! In the 
rotated position, this is the only way to draw lines to the correct 'Z' values! 
Eight lines are necessary to complete the hollowed out cube example, and this 
should give you some practice. If the image was wrong when you rotated it, just 
try to link some lines together for now. In part 4 of this section (Editor cross 
reference), we'U cover the "EDIT" mode of our Graphic editor, which will 
allow you to easily 'take back' and 'change' things that have already been 
entered. After using the "ADD" mode in this example, the reference section 
will be all you'll need to master these new options! When you've added a few 
lines (or all of them), use the "QUIT" option to exit the Graphic Editor. 
Now, you'll be asked to enter a "Viewer distance”. A good rule of thumb is to 
start with a viewer distance equal to at least two times our longest dimension. 
Since our image extends from +400 to -400, entering 2000 is a safe bet. When you 
get back to the main menu, save your image again under a different filename, and 
proceed to part 3. 


Note : While adding lines in the Rotated position, notice that the 
"Rant exists-." message no longer displays our famabar +400 and +200 
values. This is one of the prime differences between absolute "space 
coordinates" and simple measurements. You could theoretically rotate 
the image back to the original position, but it's much better to SAVE 
the image before rotating whenever possible, for quick re call of 
original values. 
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3.3 IMAGE DATA EDITOR 


In the preceding chapter, we saw that a little joystick practice is all that 
is necessary to create 3D images with ease. Changes can be made, and errors 
corrected just as easily, with the "EDIT” mode of the GRAPHIC EDITOR, as 
you'll see in part 4. However, these functions were intentionally left out of the 
last discussion, for this reason: When you add 'points' and 'lines', data is 
simply added to tables in memory. However, when you remove (or change) paints and 
lines, what happens is much more complex. An understanding of what actually 
occurs in these cases will be of great benefit, and a discussion of the IMAGE 
DATA EDITOR now, will help us to that end. Also, sooner or later you're sure to 
come up with a puzzling problem you're not sure how to correct, and then it is 
necessary to have some way of directly accessing these 'data tables', to see 
what’s going on! The IMAGE DATA EDITOR will not only provide this direct access, 
but in some cases will actually make data entry easier then the 'joystick' 
method. If you entered the 'Hollowed out CUBE' image via the GRAPHIC EDITOR, save 
it now to a disk file before proceeding. Later, we'll use the DATA EDITOR to 
examine the numerical representation of our hollowed 'CUBE' example, but first, 
let's start with a clean slate. After you've saved your current image, hold down 
the OPTION key while selecting item 2 (CREATE A NEW IMAGE) from the main menu. 


3.3.1 DATA E ditor; Basic Usage. 

This is the S3DP IMAGE DATA EDITOR. Again, rather than list all the 
functions individually, Let's discuss them in one logical sequence: 

To enter data, simply type in the values for each of your X, Y, and Z 
points, pressing RETURN after each entry, only numbers in the range of 
-32768 to +32767 are acceptable (plus signs are unnecessary but legal). If 
you enter a number outside the range, the screen editor will replace it with 
a "valid" number after you press RETURN. Note that pressing RETURN without 
an entry results in a zero being entered. Should you make an error prior to 
pressing RETURN, use the BACKS!?ACE key to correct. If you've 
^already pressed RETURN, use the (CTRL) "arrow” keys to move th< 
dcursor to the desired location and re-enter. Use (CTRL) E if< you 
wish, to ERASE the old entry before making a new one. This is not really 
necessary, but it's there if you want it. The (CTRL) "arrow” keys can only 
be used to move the cursor within the range of completed points. So you can 
use the "up" (CTRL) arrow to move up for a correction, but you will have to 
re-enter the "Z" data of the last complete point in order to "re-start" a 
new line. For this reason, you should enter all your data first, then go 
back and make corrections. Also, any time a (CTRL) action is initiated, the 
screen editor re-writes the data in the current screen position. So if 
you're in an "empty" data space, and a zero appears when you use a (CTRL) 
function, just ignore it. 
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DATA e ditor; Basic Usage, cont* 


Note that numbering of the points is automatic, and that only 
completed points are added to the total. To move between the POINT and 
LINE side of the screen, use ( CTRL. ) B or ( CTRL ) L.The 
cursor will always come back to the last location you were at, when 
switching sides. Also, when you have more than one "page” of data on 
either side of the screen, the < CTRL ) F and (CTRL.) B keys 
can be used to go FORWARD and BACK through the data, a page at a time. 
The (CTRL) arrow keys can also be used to "scroll" whatever side of the 
screen you’re on, up or down!. This, of course, will only occur when 
more than a page of data is present. (CTRL) R will send POINT 
or LINE data to the PRINTER, depending on what side of the screen you’re working 
on. Your commands are summarized at the bottom of the screen. Just remember to 
hold down the CONTROL key to initiate any of these actions. Re-enter your point 
data for the hollowed out cube now for practice! Then we’ll proceed to the lines. 
If you accidentally enter too many points, don’t worry. You’ll see how to delete 
unwanted data later in this chapter. 

Assuming all your points have been entered, it’s time to enter the 
lines that connect them. With this editor , ’point’ and ’line’ data are 
completely independent and must be entered separately. Use the 
(OTRL) R command (if your printer is on line) to get a printout 
of the point data, then proceed to the right side of the screen ("line" 
data), by pressing (CTRL) L. Again, numbering of the lines is 
automatic. The three columns of interest to us are FROM, TO, 
and COLOR (abbreviated "C."). Simply enter the points, by number, 
that you wish the S3DP to connect. Since the maximum number of points 
allowed is 255, no greater number is acceptable. If you enter a number 
above this range, the editor will subtract 255 from your entry in order 
to produce a "valid" number. For the color column, entries of 0 - 3 are 
allowed, and zero is always the ’background’ color. 

Note: A special function (CTRL "S") exists for issuing a ’Start 
Surface’ command when you are in the COLOR column. This will be 
discussed in detail in part 4 and 5 of this section. 

Do not enter a zero in the "FROM" or "TO" column since there is no "zero" point . 
Note carefully! : Zero is legal since the screen editor uses a zero, in the TO or 
FROM column, to detect the end of the line table! This is a quick and easy way to 
delete unwanted lines. It’s also a quick way to accidentally delete wanted lines! 
If you leave a zero in the TO or FROM column, all lines from that point on will 
be "cleared" when you exit the screen editor. Enter all the lines now, referring 
to your previous sketch (or example from part 1 of this section), and using the 
point numbers necessary to make the proper connections. Use only colors 1,2 or 3 
for now. When all the lines are entered, use (OTRL) Q to "quit” 
(exit) the editor. A message requesting viewer distance will appear. For an 
object, the rule of thumb is to start with a viewer distance equal to at least 
twice your longest dimension. This of course, should only be a positive number, 
and again, the "+" sign is not necessary. If you were to just press RETURN with 
no entry, a zero would be entered for you. Do this now - just hit RETURN. 
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DATA editor; Basic U sage, cont’ 


Now you are back at the main menu. Select item 4 again, while holding down 
the OPTION key, and you are right back in the editor. Notice that your screen 
data and cursor location are just as you left them. The only exception to this is 
if you entered a zero in any TO or FROM column. In that case, all lines from the 
zero on would be gone. Assuming this did not occur, use the (CTRL) Q option 
again. This time, enter a viewer distance of 2000, and press RETURN. Following 
this action, you will once again be back in the main menu. Guess what option 
we’re going to use now? Display, right? - WRONG! - SAVE ? 

Put in the data disk you prepared earlier. You did prepare one didn't you? 
If not, just find a formatted DOS 2 disk, known to have a few empty sectors. 
Don't use the master for saving - ever! Now, use option 5 to save the image, and 
use a different filename from any previous SAVEs, so nothing is lost. When the 
SAVE is complete, use option 3 to display your image. If the CUBE looks correct, 
use the ROTATE commands, etc., to check it from all sides. MAGNIFY and increase 
VIEWER DISTANCE if necessary to get a good perspective. If you find any errors 
after you rotate the image, you will have to re-LOAD it prior to re-entering the 
screen editor with option 4. Why re-LOAD? See for yourself. Rotate the image, go 
back to the main menu (START key), and use menu item 4 (plus the OPTION key) 
without re-loading. Now, look carefully at your point data. See the problem? Any 
screen motion of the image (with the exception of VIEWER DISTANCE and 
MAGNIFICATION) will change your data! This is normal. In fact, with a little 
imagination, you can use this ability to display "changed” data to create some 
very interesting effects! Think about it. 

Note: As you can see, in cases where you already have an image sketched 
out and measured (or when a blueprint is available), entering the data 
can sometimes be easier (though maybe not as much fun) with the DATA 
editor. Also, this method is much more accurate since you can type in 
virtually any combination of numbers. The graphic editor will only 
allow entries in multiples of 1,2,4,8,16,32, or 64 depending on the 
scale selected. 

Now, let's see what happens when we need to change something. From the DATA 
editor, moving a point is as easy as changing its' X,Y, and Z location. If you 
noted any errors in the displayed image, re-LOAD the data, then re-enter the DATA 
editor. Use the (CTRL) Arrow keys to move about and make the necessary changes. 
When you finish, you can display it immediately if you wish, as long as you 
remember to go back and re-SAVE the file before moving the image! Now, what if 
you accidentally entered too much data? Read the next paragraph carefully to see 
how to correct this. 
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! 

3.3.2 Garbage Collection: 


As we discussed earlier, permanent deletion of unwanted lines can be very 
easy. Just move data from the last valid line in the table, to the line you want 
to delete. Then, fill the last line with zeros, and it will automatically be 
cleared when you QUIT the editor, points however are another matter. It's ok to 
re-number lines yourself since line numbers really aren't used by the program. In 
fact, they're are only displayed for your convenience. Notice though, that the 
line data refers to specific point numbers . Deleting a point from the middle of 
the table would therefore involve changing all line references to that point. 
Ideally, it would also mean re-numbering all the points below it to fill the 
missing "slot", and changing all line references to all re-numbered points. What 
a pain in the neck!! Well, that's why we have computers - to solve number related 
"pains". The S3DP screen editor contains a utility I call GARBAGE COLLECTION, and 
it does just that! It's a bit confusing at first, but if you need it, it works 
like a charm. To delete any number of unwanted points, just fill all its 
coordinates, X,Y, and Z, with zeros. If you have a valid point with all zero 
coordinates, just temporarily change any value in it to a non zero number. Then, 
QUIT the editor, holding down the OPTION key when you press RETURN . Don't bother 
entering a viewer distance. When you get back to the main menu, go right back to 
the DATA editor (OPTION +4) and this is what you'll see: 


a) All paints have been re-numbered so that the "zeroed" points are 
gone. The total point count has been updated as well. 

b) All point references within the line column have been updated to 
reflect the re-numbering. Any line references to the deleted point 
number will be spotted easily, since it now connects to point 255. 

c) If two points were deleted, and there are lines which refer to both 
cf them, all references to the lower numbered point will now show up as 
254. The higher number deleted point references will show 255. 

This progression can go on indefinitely, and it makes sense. Since 255 is 
the maxim um allowed number of points, deleting one from the table must leave 
"slot" 255 as unused. Deleting 2 must leave 254 and 255 free, and so on. 
Interestingly, after a garbage collection, displaying your image will reveal no 
changes to any lines that don't link up to deleted points. Lines that do 
reference deleted points will usually converge to the center of the screen 
(0,0,0). To finish the job, go back to the editor and delete the "bad" lines as 
discussed earlier. Alternately, you can re-reference the lines to existing or 
newly added points. Garbage collection is a powerful utility but it is somewhat 
confusing to watch. I would suggest you try it on a small file (like the CUBE) to 
get the feel of it, before using it extensively. 
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3.3.3 Data Table Considerations 


Now that w© understand a little more about the data tables, we can see that 
deletions (particularly point deletions) can cause drastic changes. In the 
GRAPHIC Editor, these changes are even more severe! Here, point deletions remove 
not only the point, but all lines connected to it as well! In order to accomplish 
this without disturbing the rest of the image, a lot of re-numbering of points 
and re-referencing of lines takes place. The trouble is, if you are creating an 
image with the GRAPHIC editor, and numbering your points and lines on a sketch as 
you proceed, a point deletion can change everything. In the case of the 
’hollowed out cube* project, there were many opportunities for error which did 
not show up until the object was rotated, revealing its’ Z dimension. ThiB 
presents another problem! Following the rotation, a look at the DATA editor would 
reveal that all you point data has changed! 

So what have we learned? In the real world, either the ’viewer’ or the 
’object’ can move. In a 3D simulation, the object or image must always do all the 
moving. CAD workstations normally overcome these problems by keeping a copy of 
the original (un-’moved’) data in memory at all times. With the S3DP, we do not 
have the luxury of enough memory to do this. Also, when hidden surface 
elimination is discussed in detail (in PART 5), you’ll see that point and line 
deletions (especially with the GRAPHIC editor) require even more special care. 
The GRAPHIC editor may be thought of as a ’Dynamic ’ process in which both data 
and references are moved about to suit the display. The DATA editor is more of a 
’ Steady State ’ process in which entries are dealt with on an individual basis, 
and few commands effect more than a single entry. 

Despite the apparent complexity of all we’ve discussed, it’s really just 
like seeing a well stocked tool box for the first time. The first time around, 
you might need some careful tutoring on how and when to use a screwdriver, 
pliers, etc. Eventually however, it becomes second nature. The key to becoming 
proficient with the ’tools’ provided in the S3DP is to follow this manual 
through, step by step, frequently SAVEing and making printouts at the data tables 
(or at least examining them), until you’re sure of what is taking place. The 
reference "section” that follows describes each function of both editors, in 
terms of: 1) it’s visual effect on the image and 2) it’s actual effect on the 
data tables. Using them together allows near infinite control, but it will take 
some time to develop enough understanding to combine them effectively. 
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3.4 Editor Cross Ref e rence 


The following is a functional description of each GRAPHIC Editor function, 
and its' nearest equivalent using the IMAGE DATA Editor. 

3.4.1 Access from main menu (CREATE): 


GRAPHIC: Select menu item 2. All image data is cleared and you are left 
in the MODE? menu screen 

DATA: Select menu item 2 while holding the OPTION key. AH image data 
is cleared 

3.4.2 Access from main menu (EDIT): 

GRAPHIC: Select menu item 4. All image data is retained, and you are 
left in the POSITION mode. 

DATA: Select item 4 while holding OPTION. Cursor and page position are 
retained, provided you did not use the GRAPHIC Editor previously. 

3.4.3 Exit to main menu: 

GRAPHIC: Prom the MODE? menu, select the "Q" (Quit) option. If any 
image data exists, a viewer distance is requested. Exit will occur 
after this entry. 

DATA: PreBS (CTRL) "Q". If image data exists, a viewer distance is 
requested. Exit will occur after this entry. 

3.4.4 Data Entry: 

GRAPHIC: Joystick and/or keyboard. For numeric entries, Joystick button 
can be used in place of the RETURN key. When moving the cursor via 
joystick, the "S" key can be used to temporarily slow down the motion. 
Press any other key to restore normal speed. When selecting options, 
move the joystick to the right until the is next to the one you 
want, and press FIRE. Alternately, the first letter of the desired 
option can be entered through the keyboard. 

DATA: Keyboard only. Special functions implemented with CTRL key 
combinations. The OPTION/RETURN combination is also used for ’Cferbage 
Collection*. 
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Cross Ref., cont* 


3.4.5 Adding points/lines: 

GRAPHIC : Use ADD mode. Move joystick and follow screen prompts 
to enter points and lines. Linking to 'old* points is provided as 
needed. When linking, the actual point data (X,Y,Z) is displayed 
rather then the cursor position. Default Z is automatically 
appended to all new points by just pressing RETURN (or the 
joystick button) for the Z entry. Default Z can be changed anytime 
it is requested. Line color, surface starts, and surface color is 
requested once only during an ADD operation. Data table updates 
occur one step ’behind* what you are currently editing. For this 
reason, aborting an ADD operation prior to the entry of 2 
points (new or linked) and 1 line will result in no additions to 
the tables, or changes in your image. Up to 255 line and/or points 
can be entered. Attempting to add more will cause overwriting of 
your last entry. 

DATA: Points and lines are added numerically. It is possible here 
to enter a point to which no lines connect, but it will not be 
displayed. To display a ’dimensionless’ point, a line must be entered 
connecting the point to itself. This operation is almost impossible 
with the GRAPHIC editor, due to the ’one step behind’ characteristic 
described above. When entering Knee, remember that there is no ’zero’ 
point. A zero in the FROM or TO column of the line list will 
effectively cause deletion of the line, phis all tines following. There 
are no ’default’ values for any DATA editor entries, with the exception 
cf zero. Surface Starts are entered by pressing (CTRL) S in the COLOR 
column. 1 digit entries are then required (with no RETURN key press) 
for the line and surface color. After entry, Surface starts are flagged 
by the highlighted digit in the color column, or a symbol during 
printout. The surface color is not displayed on the normal editing 
screen, and can only be viewed again by re-entering. To dear a surface 
start, re-enter the line color without the (CTRL) ”S" option (see part 
5 for a complete discussion on ’surface' building). 

MENU: Points and lineq can also be entered by merging files 
together with the main menu LOAD option. This is implemented by holding 
the OPTION key while pressing RETURN to complete a filename entry. All 
point references in the Tine list’ of the file to be merged will be 
offset by the current number cf points in memory. Points and lines 
exceeding the 255 limit will be discarded. See part 5 feu: a complete 
discussion on merging. 
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3.4.6 Global Movements*: 


GRAPHIC: From the MODE? menu, select the POSITION 
mode. Rotation direction and Rotational offset controls are now 
enabled. The scaling function takes the place of the magnification in 
DISPLAY mode, however, scale changes will not effect previously 
selected magnification and via-versa. Scale normally defaults to X8. 
Once changed, it will normally remain as you set it unless you re-enter 
the editor with the CREATE option. The scales available are in 
multiples of 2 (i.e., XI, X2, X4,...X64), however, the approximate 
horizontal screen limits Eire displayed rather then this multiplier. 
When motion is completed, press the Escape key. 

DATA: No 'global* change functions. 


3.4.7 Deleting lines: 


GRAPHIC: From the MODE? menu, select EDIT. Following 
this, choose the Re move line option.You will then 
be prompted to get the first, followed by the second endpoint of the 
line with the cursor. If you 'miss* the endpoint, the message ,f No point 
found" is displayed, and you must press FIRE to re-try. When both 
endpoints have been found, you will be prompted with a final "Ok to 
delete?" message. Selecting *YES* will remove the line, move all other 
lines up one 'slot* in the line list (data table), and decrement the 
total line counter ("L=~."). The image will then be re-displayed with 
the selected line removed. Note that the points at either end of the 
line are not deleted! If you use the the 'Remove line* function on a 
line having no other lines connected to it*s endpoints, the 
re-displayed image will not show up the "floating" point(s). This 
wastes table entry space and needlessly slews down your image, so keep 
this in mind. 


DATA: To remove a single line temporarily , just change it's line color 
to Zero. Fbr a permanent deletion, manually move (re-enter) the last 
line in your list over the unwanted data. Then fill the last line on 
the list with zeros, and QUIT the editor. If a group of lines at the 
end of the line list is to be deleted, simply entering zeros into the 
first unwanted line will cause deletion from there on when you 'QUIT*. 


Note: When surfaces are involved, it is important to give special care to line 
deletion, and is best performed through the DATA editor. In these cases, more 
than one line may exist between two given points, and it will be almost 
impossible to determine which line is being deleted with the GRAPHIC editor 
alone. 
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3.4.8 Point Deletion: 


GRAPHIC: From the MODE? menu, choose EDIT. 

Following this, select the Delete Point option. You will be prompted to 
locate the desired point with the cursor, and press FIRE. If you "miss’ 
the point, press FIRE again to retry. When the point is detected, you 
will be prompted with a final M Ok to delete?" message. Selecting YES 
will delete the point and all lines directly connected with that point. 

In the data table, the deleted points and lines will be removed, and 

all data will be ’pushed up* to fill these empty ’slots’. Also, all 
point references within the line table will be re-numbered to reflect 
this deletion. If you are working with a sketch and penciling in line 
and point numbers, it is advisable to use the DATA editor to get a 
printout of these changes after the point deletion takes place. 


DATA: To delete a point from the table, fill all it’s coordinates 
(X,Y,Z) with ze ros, ’QUIT’ the editor, and hold down the OPTION key 
while pressing RETURN for the Viewer distance’ entry. As explained in 
part 3.3.2 (Garbage collection), the desired point will be removed, and 
any lines referencing it will now reference point 256. More than one 
line can be deleted by this method, but it will be confusing since the 
line references will be changed to 255,254, efcti, depending on how many 
are removed. The next step is go right back to the DATA editor, and 
decide what to do with the lines that reference point 255. Since this 
point does not exist, you must re-reference them to an existing point, 
or manually delete them (see DATA editor, line deletion). The main and 
simplest use of the DATA editor point deletion method, is to get rid of 
pemts for which there are no lines . This can occur anmw HnwMi when the 
’Remove Line* option of the GRAPHIC editor is used. 


^9^* Point deletion with the GRAPHIC editor goes one step further than what was 
called ’Garbage collection’ in part 3.3.2, however it does use some of the same 
program subroutines, and a bug exists in this procedure which has not been 
corrected (as of this writing). If a point other than the one to be deleted 
happens to be at a position where it’s X,Y, and Z dimensions all equal zero, it 
will be deleted as weH, the wrong lines may be deleted, and the lines that 
should have been deleted may be connected to a non existent point (254). Despite 
the obvious mess this would seem to make out of the image, it is highly unlikely 
that any combination of rotation or motion will cause a point to be exactly 0,0/) 
unless you put it there, in fact, on a default screen scaled to +1200, the odds 
against this occurring accidentaUy are 13,824,000,000 to 1, but *Murphy’s law 
says that it will happen it I don’t mention it! 
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3.4.9 Move point: 

GRAPHIC: To move a single point without disturbing the rest 
of the image, Select EDIT from the MODE? menu, then 
choose the Move point option. You will then be 
prompted to get the desired point with the cursor and press FIRE. If 
you 'miss’ the point, press FIRE again to re-try. When you've 
successfully 'caught* the point, move the cursor again to the new 
desired location. Momentarily pressing the FIRE button will instantly 
move the point and all connecting lines to the new location! You can 
now continue to move the cursor to refine your position if necessary. 
Each time you momentarily press FIRE, the point again moves to the new 
position. To get out of this mode, hold the FIRE button for about 3/4 
of a second, or until you hear a 'click* from the TV speaker, then 
release the button. You will then be asked for a new Z value. Although 
the X and Y values shown in the text window have changed with the 
cursor motion, the Z value displayed in this mode reflects the actual 
paint data. If you hit RETURN (or just press the FIRE button) with no 
entry, the original Z will remain unchanged. Alternately you can enter 
a new Z value, but you won't Bee the change since perspective is 
disabled. In either case, your entry will have no effect on the 
'default Z* value used by the A ID ID mode. 

DATA: In the data editor, you can change X,Y, and Z values directly. 

Just move the cursor to the desired point dimension, press (CTRL) "E" 
to erase the old entry, and enter the change. 

3.4.10 Misc. Editor functions 

1) To determine the present X,Y, and Z coordinates of a point, 
use any GRAPHIC editor function that 'finds' a point, read the data in 
the text window, and abort the operation. 

2) To obtain a printout of the point and/or line data currently 
go to the DATA editor, select 'points' or 'lines' with the 
(CTRL) P/L option, then press (CTRL) R. The printer must have been 
online during program startup for this to operate. If it was not, SAVE 
your present data, power up the printer, and hit RESET with the master 
S3DP disk in the drive. The S3DP printer driver will then initialize, 
and you can re-load your image file to obtain a printout. It is 
generally not necessary to create your own printer control file (see 
appendix I) for this function, since the printer data is sent in ASCII 
format. 

3) The screen overlay (CTRL/SHIFT) "Y" and screen save 
(CTRL/SHIFT) "T" functions are both active in the POSITION mode of the 
graphic editor. The picture file wiU be automatically centered to 
compensate for the 'split screen*. If the overlay option is used, the 
'picture' file will remain in the background until the POSITION mode is 
entered again. Note that as long as the overlay is active, deletions 
will not show up properly on the screen, even though they are working 
correctly. 
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3.5 Advanced Image Design Functions 


This final chapter deals with some of the more advanced design tools within 
the S3DP, and how to use them effectively. This section should not be put to 
actual use until you feel reasonably comfortable with basic operations discussed 
so far. By now, owners of the previous version 1 S3DP are beginning to realize 
why an entirely new manual was needed for the current version. Hopefully, new 
users as well are starting to feel they got their " money sworth". 


3.5.1 Merging Option. 

Recall from our previous discussions, that it is possible to merge an image 
file on the disk, with your current image data. This is accomplished by using the 
LOAD option, and holding the OPTION key while you press RETURN when you complete 
your filename entry. Now 'why would you want to merge files?, you may ask. Well 
actually, this is how a real CAD functions! Let's say you created an image of a 
car. Now you want to add wheels! Knowing the unfortunate lack of 'curve' 
functions in the S3DP, we certainly don't want to 're-invent' the wheel 4 times. 
In a CAD system, we would 'call up' a wheel image from a huge collection of 
'canned' files, and direct the system as to where it should be placed. The 
'wheel' file would then be loaded, moved, rotated, appropriately scaled, and 
finally merged with the current image. While the S3DP cannot perform this 
function as efficiently as a $10,000 CAD workstation, you may be surprised how 
close we can come. 

It is not my intention here to go through step by step examples. Rather, I 
want to give you some ideas, and inspire you to be creative. Imagine for example 
that we wanted to MERGE such wheels to a car, and that both the car and wheel 
files have already been designed and saved on two separate files. You could now 
load the car image, position it so the wheel will line up at the proper angle, 
and MERGE the wheel file. To make the positioning easier, you might first save 
the wheel image as a PICTURE file. Then load in (not merge) the car file, OVERLAY 
the picture file, and with the ERASE mode still disabled, move the car to the 
exact position desired (if the screen gets too 'messy', just use the overlay 
option again). When the car is in the right position, MERGE the wheel file, SAVE 
the results, and begin positioning the car for the next merge. On a more 
practical level, we could have saved about 1/2 our work on the hollowed out cube 
image with this feature. We could have drawn the outer and inner squares, both at 
Z=+400. Then after SAVing our image, use the MOVE POINT feature, or the DATA 
editor (or even a global rotation if you're careful) to change all the 'Z' values 
to -400. We could then MERGE the two images, and have only the front to back 
connection lines left to fill in. It may seem a bit cumbersome, but using the 
merge feature in this way will save you a lot of time, especially when multiple 
identical image sections are needed. To design a sphere for example, we could 
design one circle, and then simply merge it to itself at different angles. If not 
for merging, the same task could take hours! 
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3-5.2 Screen Overlay * tracing* 


I don’t know if you noticed when we mentioned it at the end of the reference 
section, but the screen OVERLAY and SAVE functions cam be used while in the 
GRAPHIC editor! This means that any ’micropainter' compatible (62 sector) picture 
file that you want to convert for use with the S3DP, can be used as a background 
while you ’trace’ paints and lines directly on the screen! Even though the ERASE 
mode is disabled, the screen editor ADD functions will operate 
almost identically as before, due to its’ use of ’XOR' drawing. Of 
course, deletions will not show up (even though they work) since 
the ERASE mode is off, but this is a minor obstacle. Returning to 
POSITION mode again will turn screen ERASEing back on and 
restore the screen to normal. This feature is very helpful in 
converting ’Logo’ designs and other two dimensional ’PICTURE’S into a 
file the S3DP can use for rotation and perspective effects!. 


3.5.3 Surface Construction 

I mentioned several times throughout this section, that the hidden 
surface function requires a special format of line construction. It 
actually requires strict adherence to many rules and conditions. For 
the S3DP, these rules are: 


1) All surfaces must be considered flat . 

2) A surface must always be convex rather then concave. Also, a 

surface cannot have a hole since this would make the shape concave 
on the inside. Here are a few examples of convex and concave 
shapes: 



3) The first line of a surface must be specified, either by the 
"Start Surface” option in the GRAPHIC editor, or by using the 
(CTRL) ’S’ command in the Color column of the DATA editor. 

4) The last line of a surface must be drawn back to the starting 

point of that surface. This implies that all surfaces must be 
’closed'. 

5) While surfaces may share ’points' in common, each surface must 

be bounded by its own lines even though this means many lines have 
to be re-drawn . This accounts for the slower animation of the 
"SBOX” image in comparison to the "CUBE”, even when the hidden 
surface option is inactive. 


page 41 



























* * * * SUPER 3D PLOTTER XX * * * * 


Surface Const., cont* 


6) A surface must not pass through another surface. 


7) During display, surfaces may be partially offscreen, but the hidden 
surface and color fill functions will not operate correctly if parts of 
a surface intersect more than one screen boundary. 


8) Single lines which are not part of a surface can only be displayed 
if they appear at the beginning of the 'line table* . These lines will 
always appear in the background, 'behind* all other surfaces. Following 
the first 'surface start' in the table, single lines must be specified 
as surface starts, or they will not be displayed when the hidden 
surface function is turned on. Single lines incidentally do not have to 
conform to rule 4, since a line has only one dimension. 

*Why all these restrictions?' you ask. In my research I found that there are 
many methods of implementing the hidden surface effect, and most of these had 
varied restrictions and rules. I also found that the only 'true' hidden surface 
elimination (that works in all cases without restrictions) requires what is 
called a 'depth array', with entries for every pixel on the screen! Even the 
Atari 130XE would not have nearly enough memory to fully implement this method. 
Most of the other approaches require so much math, that even at machine language 
speeds, you would wait several minutes for the results -and these too have many 
restrictions. So, in order to make the hidden surface function practical, some 
nrmpwwrfaw had to be made. One advantage of the method used in the S3DP is its 
speed! Virtually no real math is used at all, and a full hidden surface view 
(with or without the color fill option) is usually completed in less than a 
second! While preparing Hidden Surface images requires extra work, the effect can 
be very dramatic. 

To create the hollowed out cube image with the hidden surface effect, and 
conform to all the rules, a total of 16 surfaces are needed. The outside and 
inside surfaces account for 8 of these, and since the front and back surfaces 
have a 'hole' which is not allowed, each must be 'broken up* into 4 surfaces like 
this: 


Front or back 




3 
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Surface Const., cont* 


By doing this, we have substituted 4 convex surfaces for the front (and back) 
of the image. The closely spaced diagonal lines are not to suggest that these 
surfaces are physically separated. Rather, they illustrate the need to border 
each surface with its' own independent lines. The entire image will still share 
the original 16 points, but now we have 64 lines to enter. The best way to 
convert an image like this is to re-build the line file from scratch using the 
same points. This is easier than you might think! Just use the POSITION mode of 
the GRAPHIC editor to move your original image, so that all endpoints are 
visible. Then, while still in the POSITION mode, use the SCREEN SAVE function to 
create a picture file of the display. The next step is to go to the DATA editor, 
and delete the entire line list, by filling the first line with 'zeros' and 
exiting. Finally, go back to the GRAPHIC editor POSITION mode, and use the SCREEN 
OVERLAY function to display the image as it was, before the lines were deleted. 
Now you can use the ADD mode to 're-build' the lines, this time as separate 
surfaces. Since the 'overlay* has not been moved, every ADD operation will be a 
Link to old.. , and so no Z entries will be necessary. As an added step, you 
might want to enter the DISPLAY mode, load in the OVERLAY, and make a graphic 
printout. This will enable you to 'pencil in' the surfaces as you build them, and 
help you keep track. The only 'hitch' in this procedure, is that you must make 
absolutely sure you don't use ROTATION or ROTATIONAL OFFSET controls once the 
SCREEN SAVE function is used and the line list is deleted. Otherwise, the overlay 
will be useless in helping you locate the true position of the endpoints. 

Of course when you are building an image from scratch, there are other 
shortcuts, such as using the MERGE feature whenever possible. However, due to the 
longer line list needed to define objects with surfaces, the image will always 
move much slower (even with the hidden surface function inactive). For this 
reason, it s not a bad idea to build the image twice in this manner, so that a 
fast 'wire frame' image will always be available. 

When re-building the 'hollowed cube' image, it is necessary to make the 
diagonal lines which separate the sections of the front (and back) surface, the 
same color as the surface itself, so that they will appear as single, solid 
surfaces when the COLOR FILL function is turned on. Alternately, we could make 
these line colors 'zero', to make them invisible with the color fill disabled. Go 
to the main menu now and load in the image called 'SHCUBE'. Display the image and 
select medium resolution mode (HE-res works, but the lines are not as sharp with 
COLOR FILL views). Hit (CTRL) 'S', wait a moment, then type (SHIFT) 'S'. This is 
a completed variation of the 'hollowed cube* image. Motion (especially rotation) 
will be comparatively slower, but it certainly does look real! When making this 
image, I decided to use the DATA editor to change all the 'Z' point values to 
+200. Then, I used the OVERLAY procedure to re-build the line file as surfaces. 
Finally, the DATA editor was used to make some subtle changes in the line and 
surface colors, to optimize the image for a COLOR FILL display. Careful 
examination of this data wiU help you understand this process more fully. 
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3.5.4 Surface Priorities 


One of the toughest rules to conform to when designing Hidden Surface images 
is not the need for many lines, it is rule #6: *A surface must not pass through 
another surface. Notice the following illustration. 



Even though the "C" shape has been broken down into convex surfaces as 
required, the rectangle ’passing through’ it may not always be displayed 
correctly. You see, the hidden surface system can only work with whole surfaces. 
Any given surface must be either in front of, or behind any other surface. In 
this case, one of the surfaces is both in front of and behind the others. Since 
the S3DP must ’decide* one way or another, it issues a priority to each surface, 
based on its’ *Z’ extension. For each surface, this priority may be based on one 
of the following: 

1) The average of it’s current minimum and maximum *Z’ values. 

2) The most distant Z value only. 

3) The nearest Z value only. 

For the above example, the best solution might be to "split” the rectangle 
into two surfaces, at the point where it intersects the ’C* design. Average 
priority will then produce a proper display. Average priority usually works best, 
and bo it is used by default. However, an otherwise impossible view can sometimes 
be made to work by selecting another. To change priorities, press the 1,2, or 3 
keys, while a hidden surface image is actively being displayed. For a simple 
image like the "SHCUBE", it usually won’t matter at alL But, this may not always 
be the case! 
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3.5.4 Surface Clipping 


Because the Hidden Surface system requires that each surface be enclosed by 
its* own independent lines, it tends to get confused when a surface is partially 
offscreen. While the S3DP does contain a very fast 'line clipping' routine, 
'surface clipping' is a bit tougher. As of this writing, the 'surface clipping' 
is "intelligent" enough to deed with a surface which is partially off any one 
screen border, and is reasonably tolerant of multiple border intersections, as 
long as screen 'corners' are not involved (particularly the top corners). I am 
8till trying to improve this, but resolveing all possible special cases will 
unfortunately require more memory than we have available in a 'standard' ATARI. 
Here is a sample of the 'ultimate' surface clipping problem: 



The 'screen' to the right shows one line 
of a surface. The rest is completely 
offscreen. Can you tell which side of the 
line is part of the surface? 


*** Conclusion * * * 


The GRAPHIC and DATA editors have enough features incorporated to make 
almost anything possible. Even if you need more lines and points than the S3DP 
can handle, you can always use tricks like SCREEN OVERLAYS to 'extend' your final 
display. Although I would like to have added more editing tools, the memory just 
'ran dry' (there are exactly 68 bytes left now out of the whole 48K!). However, 
this is without a doubt the fastest and most versatile package of its' kind! Like 
any software package, the more you use it, the easier and more flexible it will 
become. One final tip: When the S3DP draws lines on the screen, it checks the 
'From' point of each line to see if it matches the last 'To' point. If it does, a 
small amount of re-calculation is bypassed. Therefore, to maximize speed, try to 
satisfy this criteria wherever practical. It's kind of like the old game where 
you see how many "dots" you can connect without lifting the pen from the page. 
The final section of this manual describes some of the more technical aspects of 
the S3DP program. This will be of value if you have an interest in graphics 
programming. Even if you don't, it will help you understand some of the features 
and limitations of the S3DP, so you can use it to best advantage. 
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SECTION XV 

* S3DP TECHNICAL INFORMATION * 


In this section, we will discuss some of the inner workings of the S3DP 
package. We will see how some of the 3D functions are implemented, and gain an 
insight into the programs' advantages, and practical limitations. Some of the 
techniques discussed will be of particular value to programmers, regardless of 
the program language. The S3DP programming however, was designed to take 
advantage of the 6502 microprocessor instruction set, and as such may not 
represent the most efficient approach from another language such as BASIC. 
Nevertheless, there should be something in this section for everyone. Just chew 
up the meat and spit out the bones. The information is always there if you need 
it. 


4.1 Overview 

The S3DP package maintains a maximum of 255 lines and/or points can be 
defined by the user. In addition, up to 85 surfaces may be specified, each 
containing any number of paints and lines. The X,Y, and Z coordinates may cover a 
range of -32768 to +32767, for a total of 65536 units on any given plane. The 
units represented actually translate into the size of one hi-res pixel. If we 
assume that a single pixel represents about 1/16 inch, then 65536 x 1/16 inch 
roughly equals 341 feet. The perspective scaleing is set up with the assumption 
that the viewer is watching the action, through the TV "window”, from a minimum 
distance of 128 pixels or, about 9 inches. This roughly equates to a 90 degree 
angle of view, on an average 19 inch TV. A 341 foot (cubed) world may seem 
However, size is a very relative thing and is largely determined by how close you 
are to the object in question. If you don't believe this, think about the last 
"el-cheapo" monster movie you saw. You think that was a reed city being trampled 
by the monster? Of course not. But setting up the camera dose with a wide angle 
lens makes it look real, at least in size and perspective. To increase the sense 
of size therefore, is simply a matter of lowering the minimum allowable 
to the TV "window". If zero is used, the perspective becomes just plain 
distortion, and the image is useless. So, a compromise must be reached. Well 
talk about this more later. For now, the point I want to make, is that no matter 
what the "world" size, the limitation is the same. If the world is not infinite , 
then at some finite distance off the "ground", the "edges" will be apparent. This 
is not quite true of the real world, even though the earth is limited in size. 
Since the planet is round, going higher will only reveal more terrain. This is 
true to quite an altitude. Also, since viewer distance in the real universe can 
stretch out to infinity, we can never reach an "overflow" condition. 
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4.2 Limitations and Overflow 


Integer "overflow" is a condition which arose when our "point” data exceeds 
our mathematical "world" size. With a range of 65536 "units" of measurement, you 
would think that this is unlikely to occur. Remember though that images are moved 
by directly changing this data, and going out of range can occur if some K 
rules are not considered. With object type images, this is usually not a problem. 
Limiting our maximum dimension to several thousand units will usually leave 
room 111 our limited world, to move our object with freedom. You may 
notice however, that a large object such as TIEFIGHTer can only be moved so far 
away, before overflow is reached. As you increase viewer distance, the image will 
shrink to about the size of a dime (depending on your screen size) before this 
occurs. When the overflow point is reached, you will see lines spurt out from the 
center in all directions. No overflow checking is done in the S3DP program 
itself, and this of course is simply to speed up processing time. So, when 
designing a world' instead of an object, great care must be taken to prevent 
this condition. A limit must be determined so that no matter how the world is 
moved or rotated, no part of the data moves out of range. Imagine for a moment a 
stationary cube, with a somewhat smaller cube on the inside which can be moved 
about. If the large, stationary cube represents our range, and the inner movable 
cube is the world we wish to design, we must be able to move every corner and 
edge of the inner cube through our central viewpoint, without allowing any 
portion of it to exceed the boundaries of the outer cube. To comply with this 
analogy , I have found that +10000 units (20000 total length in any direction) is 
about the maximum world size you can use. This is more than sufficient for good 
perspective to be realized, and maximum freedom of movement is still maintained. 


SAMPLE OF 

OVERFLOW 

CONDITION 
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4.3 Programmers Note s 


Now let's discuss a little programming for those interested. Just how are 
these 3D effects implemented? We know that math is involved, so let's look at the 
math related functions available in the 6502 microprocessor. These are: 


ADC -add with carry 

SBC -subtract with carry 

ASL/ROL -bit shift (multiply x2) 

LSR/ROR -bit shift (divide by 2) 

EOR #$FF -negate (ones complement) 

(If you don't know 6502 machine language, read on anyway. The concepts discussed 
are independent of the program language.) 

As you can see, there are not many math instructions to work with. We must, 
however, reinember that anytime we abandon basic instructions in favor of full 
scale math routines, we are wasting valuable processor time. An LSR instruction 
for example takes a few microseconds to divide a number by 2. ATARIs' "floating 
point" divide routine may take thousands of times longer! This still only amounts 
to a fraction of a second, but when a great many calculations are necessary, it 
adds up pretty fast. INTEGER math is much faster than FLOATING POINT, since only 
16 bits are used to represent both operators (divisor, multiplier, etc.) and 
results (products, quotients). It still however takes up much more time than a 
single pair of bit shift instructions. As such, only one true integer division is 
used in the entire S3DP system ! It is used in the final translation of each 3D 
point to a 2D screen coordinate. The overall formula looks like this: 


Xs 


<X*M) 

( ( Z+D ) /l? ) +M 


where: 

Xs = translated X screen position 
X = Actual X data 
Z = Actual Z data 
D = Viewer distance 

M = Assumed minimum screen to eye distance 
P = Perspective magnification 

The same calculation is then repeated for "Y" 
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I can "hear” you thinking already: "looks like a lot of math to me". Let's 
look at the divisor first and see! Z is added to D. That's a built in 6502 
function (ADC). Very efficient so far. Then we divide by P, which in the program, 
equates to magnification. Since magnification occurs only in multiples of two, we 
can use the bit shift instructions to implement the division. —Again, very 
efficient. Adding M presents no problem, so now let's look at the dividend. Do we 
really have to multiply X by M?. No! M in this program is 128 which is an even 
multiple of 2. Multiplying by 2 in binary simply means appending a zero "bit" to 
the original 16 "bit" number. (Just like putting a zero on a decimal 10 to make 
it 100). So appending 7 bits is just like multiplying by 128, and no math is 
needed at all! This 23 bit result is indeed larger than integer math will 
normally allow, but it is only a temporary condition. Since the divisor is always 
at least 128, the quotient cannot possibly exceed 16 bits. So, the final division 
can easily be handled by a modified 16 bit integer division routine. Notice that 
this is the first instance where a true division is necessary. Furthermore, since 
the divisor will not change for the Y calculation, all that remains is to do one 
more integer division. Of course, even this is an over simplification, and a 
thorough tutorial on this subject could easily fill several manuals. The main 
point to understand however is this: If we simply use textbook mathematical 
models to solve this kind of problem, we may not be taking full advantage of the 
computers capabilities. In this case, just by using constants that are multiples 
2, we have saved a tremendous amount of processor time. 


4.4 Rotation and Lina Clipping. 

Now, what about rotation? Don't we need to calculate angles, sines, cosines, 
etc.? Surely, this is the "textbook approach. You simply decide the number of 
degrees you wish to rotate, and calculate the new X,Y positions as follows: 

X' = X(cos A) - Y(sin A) 

Y' = X(sin A) + Y(cos A) 

In most 3D computer simulations, "lookup tables" are used to store all 
possible SINE and COSINE values, to avoid constant re-calculation of these 
functions. This improves speed somewhat, but several integer multiplications are 
still necessary. The S3DP uses a much different algorithm, beyond the scope of 
this manual, which enables it to perform rotation using only the built in 6502 
math functions. Not one formal integer math routine is used in the entire 
rotation algorithm! This yields a 20-50 fold speed advantage over the angular 
method - with or without lookup tables! In a similar vein, clipping of partially 
offscreen lines is usually a special option in most 3D simulations. This is 
because line clipping usually entails a great deal of integer math in order to 
shrink the endpoints of the line, to the boundaries of the screen. In the S3DP, 
an advanced computer process called "recursive, successive approximation" is used 
to eliminate all conventional math from the line clipping process. This makes the 
line clipping so fast, that no option is necessary to turn off the feature. 
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Line Clipping, cont* 

Again, a full explanation of the process is beyond what I can possibly 
include in this manual, without doubling its* present size. The basic idea 
however, is a perfect example of how to eliminate unnecessary math. Lines you 
see, cannot be allowed to be drawn beyond the screen borders. Since the screen 
display is just an 8K block of memory, this could easily ruin our display or 
worse, overwrite memory not assigned to the screen. So when we zoom in on an 
object, every line must be carefully checked to insure that only the "visible" 
part of the line is drawn. Of course we could use some conventional math to 
determine where our lines meet the screen edges, and the formulas to take all 
possibilities into account would easily fill this page. Clearly, a faster 
approach is needed. First, we determine if one, both, or neither of the endpoints 
of the line are onscreen. If both are offscreen , we must now determine if any 
part of the line does intersect the screen "window". This is not easy to 
determine without math, but we can definitely rule out some cases. If for 
example, both endpoints have too large an X value, then the entire line must be 
off the right edge of the screen. This simple comparison check can quickly be 
performed for all four screen edges. WeTl call this our "possibility" check, 
because a line that passes all four comparisons might intersect the screen. If a 
line passes this test, we keep cutting it in half (simple division by 2!), to see 
if the midpoint is on screen. With each unsuccessful cut, we check each half line 
to see which half, if any, meets our "possibility" criteria, and continue the 
process. If and when two onscreen points are found, a modified drawing routine 
can be used to extend a line through these points, and keep going until the 
screen boundary is reached. As you can probably imagine, the actual coding 
involves much more. The point is, for all you machine language programmers, a lot 
can be done just by dividing by 2 successively. The process, in fact, is called 
’successive approximation". It is used extensively in both software and hardware 
applications, to obtain very accurate results, in very little time. So if your 
doing a lot of machine language graphics programming that requires maximum speed, 
remember the power of the bit shift instructions. Don’t for a moment accept the 
textbook methods as the "only way". Rather, think creatively and experiment. You 
just might discover something new! 

There is one unfortunate drawback in the line clipping routines as they 
currently exist in the S3DP. For the sake of speed, the moment two points are 
found on screen, the line is drawn. If the algorithm continued, it could easily 
find the best two points rather than the first two. Visually, this would make 
little difference on one screen. When the SUPER HI-RES PRINTOUT is selected 
however, the inaccuracy can be seen in the occasional "broken" lines that 
accompany the printout. This is because lines clipped on one screen don’t always 
"mate" perfectly with lines on the next screen (remember 4 screens are used!). 
This is sometimes frustrating because printouts do take considerable time. The 
best approach is to immediately SAVE the data for every perfect printout under a 
different filename. Also recall that a small change in the screen image position 
can sometimes make a significant improvement in printout quality. 
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4.5 File Structure 


The S3DP saves each image in two files: one for plotted points, the second 
for lines. For the point file, the structure is as follows: 

1st Byte: Number of points 
2nd Byte: LSB, viewer distance 
3rd Byte: MSB, viewer distance 
4th Byte: Magnification O=none, 8=max 

From there on, each point follows in 6 byte format: XLSB, XMSB, YLSB, YMSB, 
ZLSB, ZMSB. The file structure of the line file is simply 3 bytes per line, FROM, 
TO, and COLOR. The ’from’ and ’to’ bytes are ’point’ numbers, and can range from 
1 to 255. Zeros should always ’mark’ the end of this table. The COLOR byte is 
normally a number from 0 to 3, for simple lines. For surface starts, bits 3 and 4 
of the COLOR byte are used to represent 4 possible surface colors, and bit 7 to 
’flag' the surface start itself. To create a surface start byte using BASIC, 
simply use the following formula: 

C Byte = line Col.+ (8 * Sur. Col) +128 

In addition, the line file must be terminated by a string of at least 3 
zero bytes. Should you venture to creating or using these files with another 
program, bear in mind that all point filenames are given the extension .PTS by 
the S3DP, and all line files, .LIN. If you're proficient in ATARI BASIC, learning 
to manipulate these files will give you even more control then the S3DP editors 
will allow! By 'loading' a line file into a string array for example, you could 
easily make "block deletions" with a few lines of code. If your good with math, 
you can even create point files of geometric solids, without even using the 
editors. 


4.6 Speed Considerations. 

It is interesting to note some of the current speed limitations of the 
program. Despite all the specialized algorithms, there are two items which simply 
cannot be improved without severe sacrifice. The worst of these is the actual 
drawing of the finished lines on the screen. The line drawing routine in the 
Atari is much too slow for animation. While the S3DP routine is perhaps 20 times 
faster, it still takes up more time than any other element of the program. The 
second time "glut" is the screen erase time. No matter how this routine is 
stripped down, it still must store a zero in every byte of the 8k screen. While 
there are other ways of erasing the image, I have still found none faster, (any 
ideas?). It is very interesting however to create a simple triangle image, and 
turn off the screen erasing. For such a simple image, turning off the erase 
function while the image is undergoing complex motion produces incredible graphic 
effects at lightning speed. Doing this with a color filled surface is even more 
exciting, and is well worth your time to investigate! 
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4.7 Future Outlook 

Depending on the amount of interest generated by this program, I will 
consider further development. What started out as the fastest true 3D screen 
image plotter available for an ATARI (or any 8 bit machine for that matter), has 
now become a versatile 3D image design system as welL To continue development, 
it almost goes without saying that more memory is required. For that reason, 
future updates (except for minor corrections of any bugs that arise) will 
probably not be practical for 48K machines. The big question now is whether to 
continue development for the ATARI 130XE, or start fresh with the 520 ST! Again, 
this will depend on user interest. In the meantime, I fully welcome your 
comments, criticisms, and suggestions, both technical and non-technical. You 
don’t have to be a programmer to know what you Id like to see done. Also, I am 
trying to assemble "image” libraries, and any ’homebrew’ images you care to send 
me would be appreciated. Any work that appears on such libraries will entitle the 
author to free copies of these supplementary disks! Since I first obtained my 
ATARI, it was my dream to create workable 3D animation. Hopefully, this program 
is just the beginning. Goodbye, and enjoy! 
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APPENDIX T 
PRINTER SUPPORT. 


in a “P**? P 001 ^ 6 ““ the S3DP 8tart8 out with a printer menu, 

ln Y hl ?\.r U 81m , P ' y 8elect y° ur P rinte r from a list. The apropriate printer 
ITnf^h 1 ,? 18 tKen f 6t Up autom atically and that’s all there is P to do. 
Unfortunately, as an mdependent software author, I just don’t have access to the 
dozens erf printers and interfaces used by ATARI owners, so the best I can do is 
aid you in creating a printer control file of your own. The S3DP package can be 
“ t p y ( P , t °™ rk . w J th ahnoat any dot matrix printer, providing the printhead is 
X§£tjcal, the printer itself has dot addressable graphics capability, and your 
printer interface transmits printer control codes correctly. Assuming none of 
ese presents a problem, there is a BASIC program included on your master S3DP 
disk which will enable you to create and test a custom made printer control file. 
Boot up the S3DP with BASIC, and as soon as the screen turns red, press BREAK, 

ffiwEES? ty P?" NEW " (RETURN). Now enter: RUN "DrPSETUP.BAS" 

(RETURN), and the file builder program will load and run. 

The file builder program displays a short menu which allows you to 1) Test 
the current control code setup to see if it works with your printer, 2) List the 
rontrol codes which appear in DATA statements at the end of the program, and 3) 
Write a printer control file to a seperate data disk when you’re sure everything 
w correct. When item 1 is selected, a test message will be sent to your printer, 
along with a graphic printout of a large, perfect square. Even if your printer is 
EPSON compatible, you should try this just to be sure. In fact, regardless of 
what Printer you have, there are many print options available that can only be 
changed through this setup proceedure. If you try the TEST GRAPHIC and the 
printer just churns out ’garbage’, press the BREAK key, re-RUN the program, and 
select item 2. The current printer control data is then listed, and the program 
riops so changes can be made. At this point, let me pause to say that setting up 
the necessary codes for your printer may require some careful study of your 
printer manual. Even if you’ve done some graphic programming, the requirements 
here are more critical since we want our printouts to be as proportional as 
possible. If you ve never ventured into your manual, now is the time! The S3DP 
worth”th ° pt j° n8 are a Powerful extension of its’ capabilities, and are well 


In the listing, DATA statements 1005, 2005, 3005, and 4005 are of interest 
to t us - Ne ver change anythi ng b ut these 4 lines! The listing is broken up into 4 

twSt ot these 18 the RESET dat *- » your printer has no ’Master 
ESET codes, you must insert whatever combination of control codes that are 
necessary to restore your printer to normal line spacing. Some printer manuals 
list rontrol codes in ASCII characters rather then 'byte* values. If this is the 
case, the back of your manual should contain an ASCII to Decimal (not HEYM 
conversion table. ‘ 
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Printers, cont* 


The RESET codes are actually a non critical option with the S3DP, and are 
not absolutely necessary. Note that the table on page 22 of the S3DP manual was 
created by substituting the codes for Condensed Mode, Superscript, and 6/72 inch 
line spacing, in place of the RESET bytes. For long ’line* and 'point* lists, 
this comes in handy! Up to 10 control bytes can be placed on any of the 4 DATA 
statements that we*re allowed to change. The codes in line 2005 Eire a bit more 
important. Here, we must put in the codes to setup the line spacing properly for 
graphic printouts. This is needed to assure that each line of graphic data lines 
up properly with the next one. If your printer manual has any graphic printout 
examples, it will probably give you the ideal codes for this purpose. Also note 
that in some printers (C.IT0H and NEC to name a few), The Graphic Density codes 
must be sent to the printer prior to any actual graphic data. If your printer 
requires this, the density codes should be added to your line spacing codes on 
line 2005. The more graphic densities your printer has, the better are your 
chances of finding one that will yield a perfectly proportional printout. In 
fact, some printers (EPSON RX-80, etc.) have special proportional modes just for 
such a purpose. If you're unsure, start with graphic density codes that permit at 
least 480 dots/line. This is a kind of 'minimum' requirement and corresponds 
closely to 'Single Density' on most printers. The next and most important line is 
3005. Here, we must enter the codes necessary to tell the printer, that the next 
192 bytes it receives will be Graphic Data . For many printers, the Graphic 
Density is built into these codes as well, so be sure to choose the Single 
Density option if this is the case. Also, if 'lo' and 'hi' byte calculations are 
needed (as with EPSON), remember to include the 'hi' byte, even though it will be 
zero in this case. 

The final line of interest is 4005. These two bytes have nothing to do with 
the printer controL Rather, they specify certain options for use by the S3DP. 
The first of these is a byte which lets the program know the pin configuration of 
your printhead. A zero means the Top pin is addressed by the most significant 
bit. If your printer has the opposite pin setup, replace this digit with a 1 
instead. Again, if you're not sure, this information should be given in your 
printer manual. The last byte is a special double density option. If your printer 
has a double density mode with twice the number of dots/line (about 960), you can 
get much darker printouts (at the expense of speed) by setting up line 3005 for 
384 dots/line. Then, change the second byte on line 4005 to 1. This tells the 
S3DP that each graphic byte must be printed twice in order to keep the printout 
proportional. If you're somewhat familiar with this type of printer setup, don't 
confuse yourself by trying to relate this to the number of bytes in the SUPER HI 
RES dump or QUICK dump options. The S3DP handles both of these with this one 
printer control setup. If this is all 'Greek' to you, don't get nervous! Just 
stick with the original Single density setup for now, and carefully study your 
printer manual to find the necessary codes. There's plenty of freedom to make 
mistakes, and you won't harm your printer if you do! 
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Printers, cont * 


When you are reasonably satisfied that your codes have been entered 
correctly, re-RUN the program and select item 1. If you tried this before and 
exited the program with the BREAK key, you should cycle the printer off and on 
first, to give it a full Reset. If a perfect square is printed, your all set. Get 
one of your DATA disks you prepared earlier, and put it into the drive. Now, 
re-RUN the program, this time selecting item 3. Your printer control file will be 
prepared in a few seconds. In addition, you may wish to repeat the process on 
another disk after setting up the DATA for double density printouts. Again, use 
the 'test graphic* to check that you have a reasonably perfect square before 
making the file. If after setting up your DATA statements, the test graphic still 
prints out garbage, don't curse out the 'Elf' on the back cover and give up! I 
don't know anyone who ever got printer control codes right in a graphic program 
the first time they ever tried. If you're having problems, the following list of 
possible causes may be of some help: 

1) If Only Characters are printed out : Check the codes in line 3005. 

The Graphic codes or the codes specifying the number of graphic bytes 

are incorrect. Don't make the mistake of entering ASCII data! This is a 
common error with printers like NEC and C.ITOH, where the manual gives 
you the codes in ASCII. You must convert them to decimal numbers! 

2) If there are gaps in every 'line' of the image : The codes 

specifying the line spacing in line 2005 are incorrect. 

3) If there appears to be an extra piece of 'line' drawn at the top 

and bottom corners of the square : The pin configuration byte (1st byte 

in line 4005 is incorrect for your printhead. If it is zero, change it 
to 1 and try again. 

4) If the length and width of the square don't match : This is 
a proportion problem and cannot always be corrected 100%. If the square 
is way off, you probably just used the wrong density codes in line 3005 
(or 2005 depending on your printer). Also, if the Density configuration 
byte (2nd byte in line 4005) does not match the chosen density, it can 
cause the square to be drastically out of shape. If the problem is 
slight, you may only be able to correct this if your printer has 
special proportional graphic densities available. Otherwise, at least 
be sure your final choice is the best available for your printer. 

Although this printer setup procedure is undoubtedly the most inconvenient 
item in the S3DP, It will definitely be worth the time spent when you make , your 
first SUPER HI-RES printout! To use your printer control file, just put the disk 
containing this file into the drive, right after the main menu appears during 
startup. Then press RESET, and you're ready to print! 
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AIPJPE NE> I X II 
File Conver sions: 


For those of you familiar with the "SOLID STATES” program in A.N.A.L.O.G. 
magazine (issue #16), a converter program is supplied on the master S3DP disk 
with the filename "EDITVERT.BAS". This BASIC program will convert files made by 
"SOLID STATES" into the format necessary for use with the S3DP. Before using the 
EDITVERT program on an actual "SOLID STATES" file, check the data values in the 
original listing. Notice that some of these files use decimal places in their 
data. Since the S3DP can only accept integers, the EDITVERT program will multiply 
all coordinates by a factor of 100 when it performs the conversion. This factor 
can be changed if necessary, by altering the value of the variable "SIZE" in line 
110 of the program. When RUN, the converter will ask for a filename. Do not use 
the "D:" prefix, just enter the appropriate filename, with a "SOLID STATES" data 
disk in the drive. The file will load in, be converted, and printed to the 
screen. Following this, you will be asked for a new filename. Put your S3DP DATA 
DISK in the drive, and remember to use 8 characters only (no file extensions) 
when you make this entry. A screen message will appear when the converted files 
have been completed. This program has only minimal "error trapping", so if you 
make an error, its probably best to start over. 




I wish to thank Tom Hudson and A.N.A.L.O.G. magazine for finding and 
publishing the "SOLID STATES" program, as this was in fact the original 
inspiration to create SUPER 3D PLOTTER. 


************************* 


Note: 'ATARI* is a registered trademark of the ATARI corporation. 
The Elfin Magic Co. is in no way affiliated with ATARI. SUPER 3D 
PLOTTER ver. 2D is the sole property at the Elfin Magic Ocw, and bears 
a copyright to that effect No one, except by written permission from 
Elfin Magic, may reproduce any part of this documentation, or the 
accompanying disk(s). 
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* Other Elfin Magic Products * 
CIRCUIT DATABASE II 

This is an enhanced version of the Electronic Circuit Schematic drawing 
program, I presented in the November, 1984 issue of A.N.A.L.O.G. magazine. The 
new enhancements include several added schematic symbols, plus a special 
converter routine which transforms the final image (made with re-defined 
characters) into an identical GRAPHICS 8 (hi-res) image. A fast machine language 
print dump routine is also included, that produces neat, labeled diagrams in 
vertical format, on almost any dot matrix printer (even the 7 pin types!). This 
program is a must for anyone concerned with the electronic field, from weekend 
hobbyist to professional. The editor is so friendly, you can actually draw 
circuit diagrams on screen faster than you could scribble them out with a pencil! 
In todays* world of fast moving technology, it is almost unthinkable that you (or 
your children) will never be exposed to electronic circuits in some form. But 
don’t be fooled by the low price! This program rivals many costing hundreds of 
dollars more! 

Price: only $12.95 !! 


ATARI BASIC, 48K, and disk drive required. Printer optional. 


SAMPLE CIRCUIT PRINTOUT 



COLLECTORf ± 
RTD 



+JL5VDC 

120UAC 

PLUG 



iQKn 

-O-wv-O 



























Software With Imagination 



New from Elfin Magic! 


Available January '89 

CHECKING ACCOUNT MANAGER - C.A.M. 

If you've ever considered using your ATARI to organize your 
checking records, but did 1 nt want to get involved with a complicated 
DATA BASE program, C.A.M. is for you! If you’re already using a 
commercial database package for checking, and have noticed that the 
job could have been done quicker with pencil and paper, C.A.M* is for 
you! If you want to use your ATARI for checking, but don't have the 
time to waste on learning a new program, C.A.M. is for you! You see, 
C.A.M. is a dedicated data base, already setup and optimized for one 
single purpose: To keep your checking records^ and do it quickly and 
easily. The program is so simple and instinctive to use, you’ll have 
it mastered in one evening! Yet, with all it’s simplicity, C.A.M. 
gives you ail the major features of much more complex (and 
expensive!) packages such as: 

Easy entry of transactions, with the ability to View and Edit 
up to seventeen entries simultaneously, on the same screen! 

Automatic calculation of monthly and per/check bank charges! 

Ability to search and list transactions by category and date, 
with automatic totalling and averaging of dollar amounts! 

Ability to search and total up to 10 categories 
simultaneously! 

Simple and informative car graph generation for easily 
spotting trends in your spending! 

And much more! This one package that actually will save you 
time, while, .giving you simple, complete, and thorough control over 
your records. Look... You've seen the quality of Elfin Magic products 
in SUPER 3D PLOTTER and CIRCUIT DATABASE. Would we waste your time 
with another checking account program, if it absolutely were not the 
best available for the money? And speaking of money, we feel the 
price :s definitely the last word here: 

Only: $12.95 (with manual on disk) 

- or “ _ 

$15.95 with pre-printed manual 


Send check or M.O. to: 

Elfin Magic 

23 Brook PI. 

E. Islip, N.Y. 11730 







NEW... 1020 PLOTTER SUPPORT! 

A BASIC program is now included which will 
draw S3DP images on the ATARI 1020 PLOTTER! To use 
this program, connect the plotter to the ATARI, 
power it up, and boot up the computer with BASIC . 
Then enter: 

RUN"D:P1020.BAS" 

The program will load and run, and attempt to 
communicate with the 1020 plotter. If it cannot, 
the message "CHECK 1020 and RE-RUN" will appear, 
indicating that the plotter is not connected or 
turned on. Refer to the 1020 manual if any such 
problems occur. If the plotter is ok, you will 
then be prompted^to "press H for help, or RETURN 
to continue. Type H the first few times you use 
the program, and read the instructions as they 
appear on the screen., if you have a basic 
understanding of the S3DP program, you should have 
no trouble. The P1020.BAS program may be stopped 
at any time via the BREAK or RESET keys, and may 
be listed and/or modified if so desired. With a 
little experimentation, you'll soon discover that 
SUPER 3D PLOTTER is indeed THE program, for making 
the 1020 plotter into a useful and practical tool. 
Enjoy! !! 


...R. Constan 
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